Skip to content

Create MCP server

POST /integrated-account/{integrated_account_id}/mcp

Path Parameters

integrated_account_idstring · uuid
required·

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

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

Request Body

configobject
methodsstring[]

The methods allowed for this server.

Example: ["GET","POST","READ","DOWNLAOD"]
tagsstring[]

The tags associated with this server.

Example: ["api","webhook"]
namestring

The name of the MCP server.

Example: My MCP server

Response Body

configobject

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

methodsstring[]

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

Example: ["list","get"]
tagsstring[]

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

Example: ["contacts","companies"]
created_atstring · date-time

Time at which the MCP server was created.

Example: 2024-01-10T10:00:00.000Z
created_bystring · uuid

ID of the user who created the MCP server.

Example: 0c1a2b3c-4d5e-6f70-8192-a3b4c5d6e7f8
expires_atstring · date-time

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

Example: 2025-12-31T23:59:59.000Z
idstring · uuid

Unique identifier for the MCP server.

Example: 2ba1f401-7183-47c5-9e39-e8e257e3c796
integrated_account_idstring · uuid

The integrated account this MCP server is bound to.

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

Human-readable name for the MCP server.

Example: Read-only HubSpot
tokenstring

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

Example: 4f1c5e0b6c2d4f8a9b3c5d7e9f0a1b2c
updated_atstring · date-time

Time at which the MCP server was last updated.

Example: 2024-01-11T12:30:00.000Z
urlstring · uri

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

Example: https://api.truto.one/mcp/4f1c5e0b6c2d4f8a9b3c5d7e9f0a1b2c
curl -X POST 'https://api.truto.one/integrated-account/{integrated_account_id}/mcp' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "My MCP server",
  "config": {}
}'
const body = {
  "name": "My MCP server",
  "config": {}
};

const response = await fetch('https://api.truto.one/integrated-account/{integrated_account_id}/mcp', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <your_api_token>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(body),
});

const data = await response.json();
console.log(data);
import requests

url = "https://api.truto.one/integrated-account/{integrated_account_id}/mcp"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
}
payload = {
    "name": "My MCP server",
    "config": {}
}

response = requests.post(url, headers=headers, params=params, json=payload)
print(response.json())