Skip to main content
GET
/
organization
/
mcp-servers
/
{server_id}
Python
import os
from datagrid_ai import Datagrid

client = Datagrid(
    api_key=os.environ.get("DATAGRID_API_KEY"),  # This is the default and can be omitted
)
mcp_server = client.organization.mcp_servers.retrieve(
    "server_id",
)
print(mcp_server.id)
{
  "object": "mcp_server",
  "id": "<string>",
  "name": "<string>",
  "icon_url": "<string>",
  "base_url": "<string>",
  "transport": "<string>",
  "protocol_version": "<string>",
  "authorization_secret_id": "<string>",
  "status": "<string>",
  "metadata": {
    "requires_oauth": true,
    "oauth_configured": true,
    "tool_count": 123,
    "last_synced_at": "<string>"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
Returns one registered MCP server configuration and metadata. Use this to inspect:
  • current base_url
  • status and sync metadata
  • configured authorization_secret_id

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

server_id
string
required

The ID of the MCP server.

Response

MCP server

object
enum<string>
required
Available options:
mcp_server
id
string
required
name
string
required
icon_url
string | null
required
base_url
string<uri>
required
transport
string
required
protocol_version
string | null
required
authorization_secret_id
string | null
required

Secret ID containing the full Authorization header value used for this registered MCP server.

status
string
required
metadata
object
required

Safe subset of server metadata exposed to API consumers.

created_at
string<date-time>
required
updated_at
string<date-time>
required