---
title: MCP server
url: https://docs.triply.cc/reference/mcp/
description: Which MCP revision the TriplyDB MCP server speaks, and every tool it gives an AI assistant.
availability:
- 'Private preview: This feature is switched on per instance, by arrangement. Get in touch if you would
  like access.'
- 'Check your contract: This feature is not part of every TriplyDB agreement. Contact us for more information.'
---

# MCP server

The TriplyDB MCP server is what an AI assistant talks to when you [connect it to TriplyDB](https://docs.triply.cc/how-to/connect-an-ai-assistant/). This page lists which revision of the protocol it speaks, and the [tools](https://modelcontextprotocol.io/specification/2025-11-25/server/tools) it offers: the actions an AI assistant can take in TriplyDB on your behalf. [Connect an AI assistant](https://docs.triply.cc/how-to/connect-an-ai-assistant/) explains how to connect one.

## Protocol

This server targets revision [2025-11-25](https://modelcontextprotocol.io/specification/2025-11-25) of the MCP specification, the latest it negotiates. A client that asks for an earlier revision is served that instead.

## Tools

Your assistant may ask your permission before it uses a tool, and show you the tool's name when it does. The table below tells you what each tool does, so you know what you are approving. It also shows what an assistant can and cannot do in TriplyDB, which helps when a conversation doesn't go as expected.

Requests for anything the list doesn't cover go to [support@triply.cc](mailto:support@triply.cc).

| Tool | What it does |
| --- | --- |
| `get_current_user` | Reports who the connection is authenticated as, which groups you belong to, and which scope (`read` or `write`) it holds. |
| `list` | Enumerates datasets, saved queries, stories, assets, graphs, groups, or group members, with pagination. |
| `delete` | Permanently deletes a dataset, saved query, story, named graph, asset, service, or group. Destructive and irreversible. |
| `resolve_url` | Turns a console URL (a dataset, saved query, or story link) into the resource behind it. |
| `update_account` | Edits a user's or a group's display name, description, or access level, or renames/moves it. |
| `create_group` | Creates a group — including a nested group — that can own datasets, queries and stories on its members' behalf. |
| `manage_group_member` | Adds, re-roles, or removes a group's members. |
| `get_dataset` | Fetches a dataset's metadata, or a schema view — its classes, predicates, datatypes and example instances — for writing SPARQL against a dataset you haven't seen before. |
| `create_dataset` | Creates a new, empty dataset under an account. |
| `update_dataset` | Edits a dataset's metadata (title, description, tags, license, access level, example resources) and its prefix declarations. |
| `import_from_urls` | Imports RDF into a dataset from one or more URLs. Runs in the background. |
| `execute_sparql` | Runs a SELECT, CONSTRUCT, DESCRIBE, or ASK query against any dataset. |
| `preview_sparql_update` | Dry-runs a SPARQL Update and reports the added/removed statement counts per graph, without committing anything. |
| `execute_sparql_update` | Runs a SPARQL Update and commits it. Always preceded by a preview of the same update, so the diff can be confirmed first. |
| `manage_service` | Creates a SPARQL or Elasticsearch service for a dataset, or syncs one with the dataset's current data. |
| `create_query` | Saves a SPARQL query (with any visualization) as a named, shareable, versioned saved query. |
| `update_query` | Edits a saved query's metadata (title, description, tags, access level), or appends a new version with new SPARQL or visualization. |
| `read_visualization_guide` | Explains which query form and variable names each saved-query visualization needs, and how to configure it. Assistants read it before saving a query with any visualization other than Table. |
| `create_story` | Publishes a data story: markdown paragraphs interleaved with embedded saved-query results. |
| `update_story` | Edits a story's title, tags or access level, or replaces its content. |

## Related guides

- [Connect an AI assistant](https://docs.triply.cc/how-to/connect-an-ai-assistant/): connecting an assistant and revoking its access.
- [HTTP API](https://api.triplydb.com/api-docs): the RESTful API the console itself is built on.
- [Glossary](https://docs.triply.cc/reference/glossary/#ai-assistants): what "AI assistant" and "MCP" mean here.