Create MCP server
/integrated-account/{integrated_account_id}/mcp
Path Parameters
The ID of the integrated account to create the MCP server for.
1ba1f401-7183-47c5-9e39-e8e257e3c795Request Body
The PublicKeyCredential returned by navigator.credentials.get(), JSON-serialized (base64url). Extra fields the browser adds are accepted and ignored.
4 properties
base64url. Max 64 KB.
base64url. Max 64 KB.
base64url. Max 64 KB.
base64url. Max 64 KB. Ignored — the credential ID resolves the user.
base64url credential ID. Max 64 KB.
base64url credential ID. Max 64 KB.
Always public-key. Max 64 characters.
public-keyOptional scoping for the MCP server. When omitted, all available tools for the integrated account are exposed.
Restrict the server to these methods. Use a method name such as list or get, or one of the groups read, write and custom.
["read"]When true, MCP requests also require a valid Truto API token in the Authorization Bearer header.
falseRestrict the server to tools whose tags intersect these values.
["crm","support"]How tools are exposed on tools/list. all lists every matching tool. discovery lists only the search_tools, get_tool_schema and call_tool meta-tools.
allalldiscovery
Step-up proof for a dashboard session. The 6-digit code from POST /auth/step-up/email-code (sent for mcp_server_create); checked only when step_up_factors includes email_code.
Optional expiry timestamp. When set, the MCP server's token is invalidated after this time.
2025-12-31T23:59:59.000ZThe name of the MCP server.
My MCP serverStep-up proof for a dashboard session. Current code from the authenticator app; checked only when step_up_factors includes totp.
Response Body
Optional scoping for the MCP server. When omitted, all available tools for the integrated account are exposed.
Restrict the MCP server to these methods. Use a method name such as list or get, or one of the groups read, write and custom. Combined with tags using AND semantics.
["list","get"]When true, MCP requests also require a valid Truto API token in the Authorization Bearer header.
falseRestrict the MCP server to tools whose effective tags (resource-level and optional resource.method tags) intersect these values.
["crm","support"]How tools are exposed on tools/list.
all(default): every matching tool schema is listed.discovery: only three meta-tools are listed (search_tools,get_tool_schema,call_tool). The client discovers and calls real tools through those.
discoveryalldiscovery
Time at which the MCP server was created.
2024-01-10T10:00:00.000ZID of the user who created the MCP server.
0c1a2b3c-4d5e-6f70-8192-a3b4c5d6e7f8Optional expiry timestamp. When set, the MCP server's token is invalidated after this time.
2025-12-31T23:59:59.000ZUnique identifier for the MCP server.
2ba1f401-7183-47c5-9e39-e8e257e3c796The integrated account this MCP server is bound to.
1ba1f401-7183-47c5-9e39-e8e257e3c795Human-readable name for the MCP server.
Read-only HubSpotBearer token used to authenticate MCP requests. Treat this as a secret; it is not retrievable after creation.
4f1c5e0b6c2d4f8a9b3c5d7e9f0a1b2cTime at which the MCP server was last updated.
2024-01-11T12:30:00.000ZFull MCP endpoint URL. Configure your MCP client with this URL to connect to the server.
https://api.truto.one/mcp/4f1c5e0b6c2d4f8a9b3c5d7e9f0a1b2ctruto mcp-tokens create '<integrated_account_id>' --name 'my-token'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": {},
"expires_at": "2025-12-31T23:59:59.000Z",
"totp_code": "your_totp_code",
"email_code": "your_email_code",
"passkey": {}
}'const body = {
"name": "My MCP server",
"config": {},
"expires_at": "2025-12-31T23:59:59.000Z",
"totp_code": "your_totp_code",
"email_code": "your_email_code",
"passkey": {}
};
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": {},
"expires_at": "2025-12-31T23:59:59.000Z",
"totp_code": "your_totp_code",
"email_code": "your_email_code",
"passkey": {}
}
response = requests.post(url, headers=headers, params=params, json=payload)
print(response.json())