Telden MCP Server

A read-only Model Context Protocol server for AI agents that need to inspect compliance state without screen scraping or write access.

Endpoint

Server URL

Production endpoint

https://telden.eu/api/mcp

Transport: MCP Streamable HTTP with JSON responses. The route also accepts authenticated GET requests for clients that open an SSE stream.

Security

Authentication

Send a workspace-scoped Telden bearer token in every request. Two token types are accepted.

User session tokens

Supabase access tokens with full access to all MCP tools. Obtain by signing in to the Telden app.

Workspace API keys

Scope-restricted keys prefixed tdn_. Created in workspace settings; carry one or more scopes that control which tools the key can call.

Authorization header

Authorization: Bearer ***

Access control

API-key scopes

API keys carry scopes that map to MCP tools. A key must have the required scope to call the corresponding tool. Session-authenticated users bypass scope checks and have full access.

Tool	Required scope
list_blocked_skus	skus:read
get_sku_dossier	skus:read
list_missing_fields	skus:read
get_import_report	extractions:read

Capabilities

Available tools

list_blocked_skus

Return blocked SKUs for the authenticated workspace with agent-readable blockers and next-action fields.

Input schema

{ "workspace_id": "uuid" }

get_sku_dossier

Return the existing SKU dossier read shape, including blockers, status, can_generate_draft, and can_publish.

Input schema

{ "sku_id": "uuid" }

list_missing_fields

Aggregate fields_required from the SKU blocker envelope so an agent can request only the missing data.

Input schema

{ "sku_id": "uuid" }

get_import_report

Return an import batch summary with row counts and the first failed rows for troubleshooting CSV imports.

Input schema

{ "import_id": "uuid" }

Setup

Client configuration

Claude Desktop

{
  "mcpServers": {
    "telden": {
      "type": "http",
      "url": "https://telden.eu/api/mcp",
      "headers": {
                    "Authorization": "Bearer ${TELDEN_ACCESS_TOKEN}"
                  }
                }
              }
            }

Cursor

{
  "mcpServers": {
    "telden": {
      "url": "https://telden.eu/api/mcp",
      "headers": {
        "Authorization": "Bearer ${TELDEN_ACCESS_TOKEN}"
      }
    }
  }
}

Safety boundary

The MCP server intentionally ships no write tools. There are no delete, bulk, approve, publish, billing, identity, invite, or admin mutation tools on this endpoint.

Start using the MCP server

Generate an API key in your workspace settings, copy the configuration above into your MCP client, and start inspecting compliance state programmatically.

Inizia la prova API Reference

14-day free trial · No credit card · EU hosting