Skip to content

MCP Tools

TBD Agents supports the Model Context Protocol (MCP) — the open standard for connecting AI models to external tools.

Supported Transports

Transport How it works
stdio Spawns a local process via npx; communicates over stdin/stdout
SSE Connects to a remote HTTP server via Server-Sent Events

Registering an MCP Server

curl -X POST http://localhost:8000/api/mcps \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "jira",
    "transport_type": "stdio",
    "connection_config": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-atlassian"],
      "env": {
        "ATLASSIAN_API_TOKEN": "...",
        "ATLASSIAN_EMAIL": "...",
        "ATLASSIAN_URL": "..."
      }
    },
    "tags": ["ticketing", "project-management"]
  }'

curl -X POST http://localhost:8000/api/mcps \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "custom-tools",
    "transport_type": "sse",
    "connection_config": {
      "url": "http://my-tool-server:3000/sse",
      "headers": {"Authorization": "Bearer secret"}
    },
    "tags": ["internal"]
  }'

Testing a Connection

After registering an MCP server, verify it works:

curl -X POST http://localhost:8000/api/mcps/<MCP_ID>/test \
  -H "Authorization: Bearer $GITHUB_TOKEN"

Listing Available Tools

See what tools an MCP server exposes:

curl http://localhost:8000/api/mcps/<MCP_ID>/tools \
  -H "Authorization: Bearer $GITHUB_TOKEN"

MCP Tags

Every MCP server can have tags — free-form labels that categorise the server by domain or function.

graph TD
    subgraph Tags
        obs[observability]
        tick[ticketing]
        doc[documentation]
        msg[messaging]
    end

    subgraph MCP Servers
        dd[Datadog MCP]
        jira[Jira MCP]
        notion[Notion MCP]
        slack[Slack MCP]
    end

    dd --- obs
    jira --- tick
    notion --- doc
    slack --- msg

    subgraph Agents
        sre[incident-responder]
        writer[doc-writer]
    end

    sre -.->|mcp_server_tags| obs
    sre -.->|mcp_server_tags| tick
    writer -.->|mcp_server_tags| doc
    writer -.->|mcp_server_tags| msg

Tag your Notion MCP as documentation, your Slack MCP as messaging, your Datadog MCP as observability, and agents pick up the right tools by declaring the categories they need.

Server Transport Tags Package
Jira / Confluence stdio ticketing @anthropic/mcp-server-atlassian
Datadog stdio observability @anthropic/mcp-server-datadog
Slack stdio messaging @anthropic/mcp-server-slack
Notion stdio documentation @anthropic/mcp-server-notion
GitHub stdio code, vcs @anthropic/mcp-server-github