Skip to content

Commit 7633396

Browse files
Document tilebox MCP server (#96)
* Document tilebox MCP server * Add usage details to MCP servers * Changelog entry for MCP server
1 parent b4734ab commit 7633396

3 files changed

Lines changed: 53 additions & 25 deletions

File tree

ai-assistance.mdx

Lines changed: 43 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -4,49 +4,67 @@ description: Large Language Models (LLMs) are powerful tools for exploring and l
44
icon: brain-circuit
55
---
66

7-
## Providing complete Tilebox context
7+
## Tilebox MCP Server
88

9-
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.
9+
The Model Context Protocol (MCP) is an open protocol that creates standardized connections between AI applications and
10+
external services. Tilebox provides such an MCP server that exposes tools for listing, querying and retrieving the schema
11+
of datasets, as well as tools for interacting with workflows.
1012

11-
<Card title="Download documentation for LLMs" icon="brain-circuit" href="https://docs.tilebox.com/llms-full.txt" horizontal>
12-
Download the complete Tilebox documentation as a plain text file to share with your AI assistant or language model.
13-
</Card>
14-
15-
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.
16-
17-
<Tip>
18-
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.
19-
</Tip>
20-
21-
## Providing tailored context via MCP
13+
### How the Tilebox MCP servers can help
2214

23-
Tilebox Docs can be installed as an MCP tool, so an MCP client can ask for detailed context on specific topics.
15+
When an AI tool like Claude, Cursor, or ChatGPT has the Tilebox MCP server configured, it can proactively invoke relevant
16+
tools. For example, when asking a question about a specific dataset, the AI tool can query the Tilebox MCP server for the
17+
dataset schema and include the correct, and up-to-date information about it in the response.
2418

25-
### For Claude Desktop
19+
Tilebox provides two MCP servers:
2620

27-
Run the following command to add Tilebox Docs to Claude:
21+
- `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.
22+
- `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.
2823

29-
```bash
30-
claude mcp add --transport http "Tilebox Docs" https://docs.tilebox.com/mcp
31-
```
24+
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.
3225

33-
### For other MCP clients
26+
### Configuring the Tilebox MCP servers
3427

35-
1. Open command palette (Cmd+Shift+P / Ctrl+Shift+P)
36-
2. Search "Open MCP settings"
37-
3. Select "Add custom MCP"
38-
4. Add to mcp.json:
28+
To configure your AI tools to use the Tilebox MCP servers, you need to point it to the correct URLs using the `http` transport.
29+
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.
3930

4031
```json
4132
{
4233
"mcpServers": {
34+
"tilebox": {
35+
"url": "https://mcp.tilebox.com/",
36+
"headers": {
37+
"Authorization": "Bearer <YOUR_TILEBOX_API_KEY>"
38+
}
39+
},
4340
"tilebox-docs": {
4441
"url": "https://docs.tilebox.com/mcp"
4542
}
4643
}
4744
}
4845
```
4946

47+
### For Claude Desktop
48+
49+
Run the following commands to add the Tilebox MCP server to Claude:
50+
51+
```bash
52+
claude mcp add --transport http "Tilebox" https://mcp.tilebox.com/ --header "Authorization: Bearer <YOUR_TILEBOX_API_KEY>"
53+
claude mcp add --transport http "Tilebox Docs" https://docs.tilebox.com/mcp
54+
```
55+
56+
## Providing the full Tilebox documentation as context
57+
58+
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.
59+
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.
60+
61+
<Card title="Download documentation for LLMs" icon="brain-circuit" href="https://docs.tilebox.com/llms-full.txt" horizontal>
62+
Download the complete Tilebox documentation as a plain text file to share with your AI assistant or language model.
63+
</Card>
64+
65+
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.
66+
5067
<Tip>
51-
The MCP server always retrieves the most up to date version of the documentation.
68+
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.
5269
</Tip>
70+
1.47 MB
Loading

changelog.mdx

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,16 @@ description: New features, updates and improvements
44
icon: rss
55
---
66

7+
<Update label="January 2026">
8+
<Frame>
9+
![MCP Server](/assets/changelog/2026-01-02-mcp-server.png)
10+
</Frame>
11+
12+
## MCP Server for Datasets and Workflows
13+
14+
Introducing the [Tilebox MCP server](/ai-assistance), which provides tools for AI agents to access and interact with Tilebox datasets and workflows.
15+
</Update>
16+
717
<Update label="November 2025">
818
## Job List View: Complete Redesign and Filtering Improvements
919

0 commit comments

Comments
 (0)