mcp

Bind a declared MCP server: roles, approved tools and credential

put/mcp/projects/{projectId}/servers/{serverName}

Request

  • Base URL: https://api.letsship.ai/v1
  • URL: https://api.letsship.ai/v1/mcp/projects/{projectId}/servers/{serverName}
  • Auth: none declared

Path parameters

projectIdstring required
serverNamestring required

Request body

rolesMcpRole[] required
transport'remote' | 'isolate' | 'local'

remote: the gateway proxies to the server's URL. isolate: the gateway runs the server's npm package in an isolated runtime. local: the server runs inside the agent's sandbox (no credential).

remoteUrlstring uri

Response

Binding

transport'remote' | 'isolate' | 'local' required

remote: the gateway proxies to the server's URL. isolate: the gateway runs the server's npm package in an isolated runtime. local: the server runs inside the agent's sandbox (no credential).

status'ready' | 'needs_credential' | 'needs_reconnect' | 'origin_changed' | 'bundling' | 'bundle_failed' | 'not_isolatable' required
statusDetailstring nullable required
rolesMcpRole[] required
authKind'none' | 'headers' | 'oauth' | 'isolate-env' required
pinnedUrlstring nullable required
packageSpecstring nullable required
allowedEgressHostsstring[] required
credentialFieldsstring[] required
toolsRefreshedAtinteger nullable required
createdAtinteger required
updatedAtinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.