Get MCP server by ID
PreviewConnect model providers, discover models and configure MCP servers, search providers and plugins.
/v1/mcp-servers/{server_id}See authentication for credentials and permissions.
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”MCP server ID (prefixed, e.g., mcp_…)
Responses
200MCP server found
MCP server found
Wrapper that adds API and UI links to a serialized resource.
Uses self_url (not url) for the API link to avoid collision with
resources that already have a url field (e.g. McpServer). The
allowed_actions array carries state-aware hypermedia links — empty
(and omitted from the wire shape) until the underlying resource opts
into the convention by overriding ResourceUrlable::allowed_actions.
object
Whether an API key has been configured.
Timestamp when the MCP server was archived.
Authentication mode for this MCP server.
Whether this OAuth preset’s sign-in service was reachable when it was last checked. Present only on OAuth presets.
object
When the check ran; absent when it has not run.
Host of the request that failed, when the check failed.
Short, safe explanation of a failed check.
Check outcome.
Timestamp when the MCP server was created.
Timestamp when the MCP server was deleted.
Human-readable description of the MCP server.
Which elicitation modes this server may use (url by default).
Additional HTTP headers for authentication. Keys are header names, values are header values.
object
Unique identifier for the MCP server.
Display name of the MCP server.
Stable provider id used for user-scoped OAuth connections.
Title, icon, and links published by the remote server.
The operator name and description are unchanged.
object
Which documents contributed. Not shown in the UI.
Protocol-era adoption policy for the MCP client (auto negotiates).
Connection provider whose connection on an agent’s service virtual user supplies the service credential instead of an MCP OAuth grant.
Current lifecycle status of the MCP server.
How long one tool call may take, in milliseconds. Absent means the 60000 default.
Transport type (currently only HTTP supported).
Timestamp when the MCP server was last updated.
URL of the MCP server endpoint.
State-aware hypermedia actions the caller can take on this resource
next (e.g. cancel, events, update). Omitted from the wire
shape when empty so resources that haven’t opted into the
convention don’t grow their payloads.
Agent-actionable link describing a follow-up the caller can take. Used in two contexts:
- Error recovery —
ErrorResponse.allowed_actionscarriesrels likeretry,retry-later,unarchive,get-existingso the agent knows the right next call after a 4xx/429. - Entity hypermedia —
WithUrls<T>.allowed_actionscarries state-awarerels likecancel,events,self,updateon the entity itself so the agent can follow links instead of reconstructing routes from prose.
The shape is intentionally identical across both contexts; the closed
rel vocabulary distinguishes them.
object
Short, agent-readable hint (e.g. “Shorten ‘name’ to <= 200 chars.”, “Cancel the active turn for this session.”).
Absolute (preferred) or relative URL the caller may invoke
directly. Always present on entity hypermedia actions
(WithUrls<T>.allowed_actions); optional on error-recovery
actions (ErrorResponse.allowed_actions) where the matching
operation_id is enough and the URI is implicit from the failed
call.
HTTP method to use against href. Required for entity hypermedia
actions; usually omitted on error-recovery actions where the same
operation is retried with its original method.
OpenAPI operationId the caller should invoke. Lets an MCP client
resolve the call without parsing href.
Link relation describing the action. Examples: self, cancel, pause,
resume, events, retry, retry-later, unarchive,
get-existing, delete, update.
OpenAPI $ref to the request-body schema, when the action takes one
(e.g. #/components/schemas/UpdateSessionRequest). Lets a tool-calling
agent fetch the input shape without scanning the whole spec.
Full API endpoint URL for this resource.
Alias for view_url, used by command and MCP outputs.
Full UI URL for viewing this resource.
Example
{ "auth_mode": "none", "connection_check": { "host": "mcp.linear.app", "status": "ready" }, "description": "Atlassian MCP Server for Jira and Confluence", "elicitation_policy": "url", "id": "mcp_01933b5a00007000800000000000001", "name": "atlassian-mcp-server", "presentation": { "icons": [ { "theme": "light" } ], "title": "GitHub MCP Server", "website_url": "https://github.com" }, "protocol_mode": "auto", "service_connection_provider": "github", "status": "active", "tool_timeout_ms": 300000, "transport_type": "http", "url": "https://mcp.atlassian.com/v1/mcp", "allowed_actions": [ { "method": "POST" } ]}400Invalid server ID
Invalid server ID
404MCP server not found
MCP server not found
500Internal server error
Internal server error