Telden MCP Server

A Model Context Protocol server for AI agents that need to inspect compliance state, export SKU data, upload documents, trigger re-extraction, and import SKUs — all through a single, authenticated endpoint with scope-restricted 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
exportSku	export
triggerExtraction	extractions:write
uploadDocument	extractions:write
importSkus	import:write

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" }

exportSku

Export a SKU dossier as structured JSON or CSV data with all fields, entities, documents, warnings, and issues. Requires workspace ownership for session-authenticated users and the export scope for API keys.

Input schema

{ "sku_id": "uuid", "format": "json" }

triggerExtraction

Queue extraction/re-extraction for a SKU (all documents) or a single document. Supports dry_run for safe preview and idempotency_key to prevent duplicate submissions. Compliance-affecting; API-key callers require explicit approval.

Input schema

{ "target_type": "sku | document", "target_id": "uuid", "dry_run": false, "idempotency_key": "optional-string" }

uploadDocument

Upload a PDF document and attach it to a workspace-owned SKU. Accepts base64-encoded content with filename and MIME type. Supports dry_run for safe preview and idempotency_key to prevent duplicate uploads. Optionally triggers extraction after upload.

Input schema

{ "sku_id": "uuid", "content": "base64-string", "filename": "report.pdf", "mime_type": "application/pdf", "document_type": "test_report", "dry_run": false, "idempotency_key": "optional-string", "trigger_extraction": true }

importSkus

Import SKUs from CSV/TSV text or structured row data. Supports dry_run for preview, explicit column mapping, idempotency, plan-limit enforcement, and row-level error reporting.

Input schema

{ "csv_text": "sku_code,product_name\nABC-1,Widget", "mapping": { "sku_code": "SKU" }, "dry_run": false, "idempotency_key": "optional-string" }

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 limits write access to safe, audited tools with explicit scope requirements: exportSku, triggerExtraction, uploadDocument, and importSkus. 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.

Start free API Reference

Free during early access · No credit card · Pricing starts after General Availability · Existing workspaces get 30 days notice before pricing changes