MCP quickstart

TG.app ships two remote MCP servers (Streamable HTTP) for creators:

Server	URL	Use case
Creator MCP	https://tg.app/mcp/creator	Listings, communities, promotions, analytics
Support MCP	https://tg.app/mcp/support	Tickets, knowledge base, AI replies, widget stats

1. Create an API key

1. Sign in at tg.app.
2. Open Creator Studio → Integrations → MCP.
3. Click Create API key and choose Creator or Support server.
4. Copy the secret (tg_mcp_…). It is shown once.

2. Configure Cursor

Add to your MCP config (replace the token):

{
  "mcpServers": {
    "tg-app-creator": {
      "url": "https://tg.app/mcp/creator",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

Use https://tg.app/mcp/support for the Support MCP.

Claude Desktop

Add a custom connector or MCP entry (wording varies by version):

{
  "mcpServers": {
    "tg-app-support": {
      "url": "https://tg.app/mcp/support",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_KEY"
      }
    }
  }
}

Use https://tg.app/mcp/creator for the Creator MCP.

3. OAuth (optional)

For clients that use OAuth instead of a static key:

1. POST /api/creator/mcp/oauth/authorize (session cookie) with { "server": "creator", "client_id": "your-client" }.
2. Exchange the code at POST /api/oauth/mcp/token with grant_type=authorization_code.

Scopes

Scope	Access
creator:read	Read listings and analytics
creator:write	Update drafts, submit listings
support:read	Tickets, KB, suggest reply
support:write	Reply, update tickets, KB writes
payments:order	Promotion catalog
catalog:read	Public catalog search

REST API

MCP tools call the same backend as /api/v1/creator/* and /api/v1/support/*. OpenAPI: https://tg.app/api/v1/openapi.

Observability

• Tool calls are logged in Integrations → Recent tool calls.
• Rate limit: 120 requests per minute per key.
• Header X-MCP-Version: 2026-03-01 on MCP responses.

MCP Apps (UI)

Tools preview_listing_card and ticket_inbox include bundled UI for MCP App hosts that support interactive panels.

Code execution (batch)

Whitelisted batch tools (run_batch_operation) support bulk KB import (Support) and bulk tag updates on drafts (Creator). Strict limits apply. See tool reference.