diff --git a/ai-assistance.mdx b/ai-assistance.mdx
index d5d5702..e9bd5c3 100644
--- a/ai-assistance.mdx
+++ b/ai-assistance.mdx
@@ -4,42 +4,39 @@ description: Large Language Models (LLMs) are powerful tools for exploring and l
icon: brain-circuit
---
-## Providing complete Tilebox context
+## Tilebox MCP Server
-AI assistants and Large Language Models (LLMs) can answer questions, guide you in using Tilebox, suggest relevant sections in the documentation, and assist you in creating workflows.
+The Model Context Protocol (MCP) is an open protocol that creates standardized connections between AI applications and
+external services. Tilebox provides such an MCP server that exposes tools for listing, querying and retrieving the schema
+of datasets, as well as tools for interacting with workflows.
-
-Download the complete Tilebox documentation as a plain text file to share with your AI assistant or language model.
-
-
-The full content of the Tilebox documentation is available in plain markdown format at [https://docs.tilebox.com/llms-full.txt](https://docs.tilebox.com/llms-full.txt). Upload this document to your AI assistant or LLM to provide it with Tilebox-specific context.
-
-
-The [Documentation Context](https://docs.tilebox.com/llms-full.txt) is updated whenever the documentation changes. If you download the file, refresh it occasionally to stay up-to-date.
-
-
-## Providing tailored context via MCP
+### How the Tilebox MCP servers can help
-Tilebox Docs can be installed as an MCP tool, so an MCP client can ask for detailed context on specific topics.
+When an AI tool like Claude, Cursor, or ChatGPT has the Tilebox MCP server configured, it can proactively invoke relevant
+tools. For example, when asking a question about a specific dataset, the AI tool can query the Tilebox MCP server for the
+dataset schema and include the correct, and up-to-date information about it in the response.
-### For Claude Desktop
+Tilebox provides two MCP servers:
-Run the following command to add Tilebox Docs to Claude:
+- `https://mcp.tilebox.com/` - This MCP server provides tools for accessing and interacting with Tilebox datasets and workflows. It requires authentication using a Tilebox API key.
+- `https://docs.tilebox.com/mcp` - This MCP server provides access to the Tilebox documentation. It does not require authentication. When configured, AI agents can ask for detailed context on specific topics.
-```bash
-claude mcp add --transport http "Tilebox Docs" https://docs.tilebox.com/mcp
-```
+Together, these two MCP servers provide a powerful way to interact with Tilebox using AI tools. A coding assistant can learn how to use and write code against Tilebox APIs (by using and exploring the docs), but then also specifically customize the code depending on actually available datasets, and their exact schema, queried from the Tilebox MCP server.
-### For other MCP clients
+### Configuring the Tilebox MCP servers
-1. Open command palette (Cmd+Shift+P / Ctrl+Shift+P)
-2. Search "Open MCP settings"
-3. Select "Add custom MCP"
-4. Add to mcp.json:
+To configure your AI tools to use the Tilebox MCP servers, you need to point it to the correct URLs using the `http` transport.
+Additionally you'll need to provide an `Authorization` header with your Tilebox API key as the bearer token for the `https://mcp.tilebox.com/` server.
```json
{
"mcpServers": {
+ "tilebox": {
+ "url": "https://mcp.tilebox.com/",
+ "headers": {
+ "Authorization": "Bearer "
+ }
+ },
"tilebox-docs": {
"url": "https://docs.tilebox.com/mcp"
}
@@ -47,6 +44,27 @@ claude mcp add --transport http "Tilebox Docs" https://docs.tilebox.com/mcp
}
```
+### For Claude Desktop
+
+Run the following commands to add the Tilebox MCP server to Claude:
+
+```bash
+claude mcp add --transport http "Tilebox" https://mcp.tilebox.com/ --header "Authorization: Bearer "
+claude mcp add --transport http "Tilebox Docs" https://docs.tilebox.com/mcp
+```
+
+## Providing the full Tilebox documentation as context
+
+Rather than relying on the Tilebox Docs MCP server, you can also provide the full Tilebox documentation as context to your AI assistant or language model.
+To do so, you can download the complete documentation as a plain text file below. This is an alternative to configuring the `https://docs.tilebox.com/mcp` MCP server.
+
+
+Download the complete Tilebox documentation as a plain text file to share with your AI assistant or language model.
+
+
+The full content of the Tilebox documentation is available in plain markdown format at [https://docs.tilebox.com/llms-full.txt](https://docs.tilebox.com/llms-full.txt). Upload this document to your AI assistant or LLM to provide it with Tilebox-specific context.
+
-The MCP server always retrieves the most up to date version of the documentation.
+The [Documentation Context](https://docs.tilebox.com/llms-full.txt) is updated whenever the documentation changes. If you download the file, refresh it occasionally to stay up-to-date.
+
diff --git a/assets/changelog/2026-01-02-mcp-server.png b/assets/changelog/2026-01-02-mcp-server.png
new file mode 100644
index 0000000..2a2405e
Binary files /dev/null and b/assets/changelog/2026-01-02-mcp-server.png differ
diff --git a/changelog.mdx b/changelog.mdx
index 4de15ec..436598c 100644
--- a/changelog.mdx
+++ b/changelog.mdx
@@ -4,6 +4,16 @@ description: New features, updates and improvements
icon: rss
---
+
+
+ 
+
+
+ ## MCP Server for Datasets and Workflows
+
+ Introducing the [Tilebox MCP server](/ai-assistance), which provides tools for AI agents to access and interact with Tilebox datasets and workflows.
+
+
## Job List View: Complete Redesign and Filtering Improvements