Create MCP server for an integrated account

Creates a new MCP server for the specified integrated account.

Endpoint

http

POST /integrated-account/{integrated_account_id}/mcp

Path parameters

integrated_account_id

string · uuid

REQUIRED ·

The ID of the integrated account to create the MCP server for.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795

Request Body

name

string

The name of the MCP server.

Example: My MCP server

config

object

methods

string[]

The methods allowed for this server.

Example:

[
  "GET",
  "POST",
  "READ",
  "DOWNLAOD"
]

Response Body

string · uuid

Unique identifier for the MCP server.

Example: 2ba1f401-7183-47c5-9e39-e8e257e3c796

name

string

Human-readable name for the MCP server.

Example: Read-only HubSpot

integrated_account_id

string · uuid

The integrated account this MCP server is bound to.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795

config

object

Optional scoping for the MCP server. When omitted, all available tools for the integrated account are exposed.

methods

string[]

Restrict the MCP server to these Truto method names. Combined with tags using AND semantics.

Example:

[
  "list",
  "get"
]

tags

string[]

Restrict the MCP server to tools whose resources carry these tags.

Example:

[
  "contacts",
  "companies"
]

expires_at

string · date-time

Optional expiry timestamp. When set, the MCP server's token is invalidated after this time.

Example: 2025-12-31T23:59:59.000Z

created_by

string · uuid

ID of the user who created the MCP server.

Example: 0c1a2b3c-4d5e-6f70-8192-a3b4c5d6e7f8

created_at

string · date-time

Time at which the MCP server was created.

Example: 2024-01-10T10:00:00.000Z

updated_at

string · date-time

Time at which the MCP server was last updated.

Example: 2024-01-11T12:30:00.000Z

token

string

Bearer token used to authenticate MCP requests. Treat this as a secret; it is not retrievable after creation.

Example: 4f1c5e0b6c2d4f8a9b3c5d7e9f0a1b2c

url

string · uri

Full MCP endpoint URL. Configure your MCP client with this URL to connect to the server.

Example: https://api.truto.one/mcp/4f1c5e0b6c2d4f8a9b3c5d7e9f0a1b2c