MCP configurations

Expose AgentKit tools over MCP so hosts like Claude Desktop or Cursor can call connected-account tools through a standard protocol.

Configure an MCP server, attach connected accounts, and issue tokens for clients. See Error handling for API exceptions.

scalekit_client.actions.mcp.create_config

classMcpClient

#asyncactions.mcp.create_config

Runs scalekit_client.actions.mcp.create_config and returns the result.

paramnamestr

Config name Required.

paramdescriptionstr

Human-readable summary of what this MCP config exposes

paramconnection_tool_mappingslist

List of McpConfigConnectionToolMapping objects

returnsCreateMcpConfigResponse

Create mcp config.

response = scalekit_client.actions.mcp.create_config(
    name="My agent tools",
    description="Connectors exposed to the agent",
)
# response.config

scalekit_client.actions.mcp.list_configs

classMcpClient

#asyncactions.mcp.list_configs

Runs scalekit_client.actions.mcp.list_configs and returns the result.

parampage_sizeint

Maximum configs per page (server default if omitted)

parampage_tokenstr

Opaque cursor from a previous list response

paramfilter_idstr

Filter by config ID

paramfilter_namestr

Filter by exact name

paramfilter_providerstr

Filter by provider slug

paramfilter_mcp_server_urlstr

Filter by MCP server URL

paramsearchstr

Free-text search on name

returnsListMcpConfigsResponse

ListMcpConfigsResponse.

page1 = scalekit_client.actions.mcp.list_configs(page_size=10)
for cfg in page1.configs:
    print(cfg.name, cfg.mcp_server_url)

scalekit_client.actions.mcp.update_config

classMcpClient

#asyncactions.mcp.update_config

Runs scalekit_client.actions.mcp.update_config and returns the result.

paramconfig_idstr

MCP config ID from create_config or list_configs.

paramdescriptionstr

New human-readable description for this config

paramconnection_tool_mappingslist

Replaces existing mappings

returnsUpdateMcpConfigResponse

UpdateMcpConfigResponse.

response = scalekit_client.actions.mcp.update_config(
    config_id="cfg_01abc123",
    description="Updated description",
)

scalekit_client.actions.mcp.delete_config

classMcpClient

#asyncactions.mcp.delete_config

Runs scalekit_client.actions.mcp.delete_config and returns the result.

paramconfig_idstr

MCP config ID to delete Required.

returnsDeleteMcpConfigResponse

DeleteMcpConfigResponse.

scalekit_client.actions.mcp.delete_config(config_id="cfg_01abc123")

scalekit_client.actions.mcp.list_mcp_connected_accounts

classMcpClient

#asyncactions.mcp.list_mcp_connected_accounts

Runs scalekit_client.actions.mcp.list_mcp_connected_accounts and returns the result.

paramconfig_idstr

Virtual MCP config ID.

paramidentifierstr

User identifier Required.

paraminclude_auth_linkbool

Include auth/re-auth URLs.

returnsListMcpConnectedAccountsResponse

List mcp connected accounts.

state = scalekit_client.actions.mcp.list_mcp_connected_accounts(
    config_id="cfg_01abc123",
    identifier="alice@example.com",
    include_auth_link=True,
)
for account in state.connected_accounts:
    if account.connected_account_status != "active":
        print(account.connection_name, account.authentication_link)

scalekit_client.actions.mcp.create_session_token

classMcpClient

#asyncactions.mcp.create_session_token

Mints a short-lived session token scoped to a user and a Virtual MCP Server config.

parammcp_config_idstr

Virtual MCP Server config ID Required.

paramidentifierstr

User identifier Required.

paramexpirytimedelta

Token lifetime (server default if omitted, typically 1 hour).

returnsCreateMcpSessionTokenResponse

Tokens and claims.

from datetime import timedelta

resp = scalekit_client.actions.mcp.create_session_token(
    mcp_config_id="cfg_01abc123",
    identifier="alice@example.com",
    expiry=timedelta(hours=1),
)
headers = {"Authorization": f"Bearer {resp.token}"}