Skip to content

Update MCP server

PATCH /integrated-account/{integrated_account_id}/mcp/{id}

Path Parameters

integrated_account_idstring · uuid
required·

The ID of the integrated account.

Example: 1ba1f401-7183-47c5-9e39-e8e257e3c795
idstring · uuid
required·

The ID of the MCP server to update.

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

Request Body

configobject

Updated configuration settings for the MCP server

methodsstring[]

Restrict the server to these methods. Use a method name such as list or get, or one of the groups read, write and custom.

Example: ["read"]
require_api_token_authboolean

When true, MCP requests also require a valid Truto API token in the Authorization Bearer header.

Example: false
tagsstring[]

Restrict the server to tools whose tags intersect these values.

Example: ["crm","support"]
tool_exposurestring

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.

Example: all
Possible values:
alldiscovery
expires_atstring · date-time

Optional expiry timestamp. Send null to remove the expiry.

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

The new name for the MCP server.

Example: Updated 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 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.

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

When true, MCP requests also require a valid Truto API token in the Authorization Bearer header.

Example: false
tagsstring[]

Restrict the MCP server to tools whose effective tags (resource-level and optional resource.method tags) intersect these values.

Example: ["crm","support"]
tool_exposurestring

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.
Example: discovery
Possible values:
alldiscovery
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
updated_atstring · date-time

Time at which the MCP server was last updated.

Example: 2024-01-11T12:30:00.000Z
truto mcp-tokens update '<integrated_account_id>' '<token_id>' -b '{"name": "updated-name"}'
curl -X PATCH 'https://api.truto.one/integrated-account/{integrated_account_id}/mcp/{id}' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Updated MCP server",
  "config": {},
  "expires_at": "2025-12-31T23:59:59.000Z"
}'
const body = {
  "name": "Updated MCP server",
  "config": {},
  "expires_at": "2025-12-31T23:59:59.000Z"
};

const response = await fetch('https://api.truto.one/integrated-account/{integrated_account_id}/mcp/{id}', {
  method: 'PATCH',
  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/{id}"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
}
payload = {
    "name": "Updated MCP server",
    "config": {},
    "expires_at": "2025-12-31T23:59:59.000Z"
}

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