Mcp servers
Botyard REST API endpoints for mcp servers.
23 endpoints in this group. Every request authenticates with an API key; see the API reference for the other groups.
- List Mcp Servers:
GET /v1/orgs/{org_id}/mcp-servers - Create Mcp Server:
POST /v1/orgs/{org_id}/mcp-servers - Search Mcp Catalog:
POST /v1/orgs/{org_id}/mcp-servers/catalog/search - Get Mcp Catalog Entry:
GET /v1/orgs/{org_id}/mcp-servers/catalog/{mcp_catalog_entry_id} - Start Composio Connection:
POST /v1/orgs/{org_id}/mcp-servers/connections - Get Composio Credential Form:
GET /v1/orgs/{org_id}/mcp-servers/catalog/{mcp_catalog_entry_id}/credential-form - Install Composio Connection With Credentials:
POST /v1/orgs/{org_id}/mcp-servers/connections/credentials - Get Composio Connection:
GET /v1/orgs/{org_id}/mcp-servers/connections/{composio_connection_id} - Cancel Composio Connection:
DELETE /v1/orgs/{org_id}/mcp-servers/connections/{composio_connection_id} - Get Mcp Connect Request:
GET /v1/orgs/{org_id}/mcp-servers/connect-requests/{request_id} - Reconnect Composio Connection:
POST /v1/orgs/{org_id}/mcp-servers/connections/{composio_connection_id}/reconnect - Get Composio Credential State:
GET /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/composio-credentials - Update Composio Credentials:
PUT /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/composio-credentials - Get Mcp Server:
GET /v1/orgs/{org_id}/mcp-servers/{mcp_server_id} - Update Mcp Server:
PATCH /v1/orgs/{org_id}/mcp-servers/{mcp_server_id} - Delete Mcp Server:
DELETE /v1/orgs/{org_id}/mcp-servers/{mcp_server_id} - List Mcp Server Assignments:
GET /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/assignments - Refresh Mcp Server Tools:
POST /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/refresh-tools - Restart Mcp Server:
POST /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/restart - Set Mcp Server Access:
PUT /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/access - List Mcp Server Members:
GET /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/members - Add Mcp Server Member:
PUT /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/members - Remove Mcp Server Member:
DELETE /v1/orgs/{org_id}/mcp-servers/{mcp_server_id}/members/{actor_type}/{actor_id}
Fetch a platform catalogue entry's cached logo artwork
Serve one platform catalogue entry's cached logo, or 404. A 404 is a perfectly normal outcome — it means the importer has not cached artwork for this entry, or never could — and the frontend renders the rust ``Plug`` for it. Nothing here ever reaches upstream: if the bytes are not in our database, the answer is "no", not "hold on while I go and ask Composio".
List Mcp Servers
List the caller's non-deleted MCP servers in this org, with Composio health re-checked. Not "the org's servers" — servers are private. ``visible_to`` narrows the result to what the policy engine's collection answer admits for this actor, which for an org owner (who holds the ``mcp_server.manage`` bypass) is still everything, and for everyone else is their memberships. The listing is also where Composio revalidation happens (#2689), and that is a cost decision rather than a convenience. A background sweep over every org's connections is work a shared service pays for tenants nobody is looking at, against a Composio control-plane bucket shared org-wide; revalidating where somebody is actually looking scales with viewers instead, and ``REVALIDATE_INTERVAL`` keeps a held refresh key from meaning a vendor call per render. See :meth:`ComposioConnectService.revalidate`.