Manage Keys & ServersProbe a server and sync its tools

Probe a server and sync its tools

Connects to the upstream server, lists its tools, and reconciles them into the catalog: tools are matched by name, so an existing tool keeps its id and its per-location access records across probes. Tools the server no longer reports are deleted, along with their access records. Stamps last_probed_at.

curl -X POST "https://mythic-analytics.gulp.workers.dev/builder/mcp/servers/123e4567-e89b-12d3-a456-426614174000/probe" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "success": true,
  "data": {
    "server_id": "123e4567-e89b-12d3-a456-426614174000",
    "tools_discovered": 12,
    "tools": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "server_id": "123e4567-e89b-12d3-a456-426614174000",
        "server_name": "Internal research server",
        "name": "search_papers",
        "display_name": "Search Papers",
        "description": "example_string",
        "input_schema": {},
        "annotations": {},
        "is_enabled": true,
        "created_at": "2024-12-25T10:00:00Z"
      }
    ]
  }
}
POST
/builder/mcp/servers/{id}/probe
POST
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

An agency key (ak_). Location secret keys are rejected. Scoped keys (mcp_) are not accepted here (403 not_available_to_scoped_keys).

An agency key (ak_). Location secret keys are rejected. Scoped keys (mcp_) are not accepted here (403 not_available_to_scoped_keys).
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. An agency key (ak_). Location secret keys are rejected. Scoped keys (mcp_) are not accepted here (403 not_available_to_scoped_keys).

Path Parameters

Responses

successboolean
dataobject