Skip to main content
Glama

Generate a connection-scoped MCP URL

get_unified_connection_mcp_url

Get the MCP remote server URL for a specific connection ID. Returns a ready-to-use, connection-scoped Streamable HTTP MCP endpoint that exposes that connection's integration-specific tools. Authenticate with a workspace API key to use this. The URL embeds a credential and grants tool access without a further login, so treat it as a secret. It does NOT expire on its own. Revocation depends on the mode (see the mode parameter): an 'api'-mode URL carries the workspace API key and is revoked by rotating that key (which affects every URL that used it); a 'user'-mode URL is scoped to this one connection and is revoked by deleting the connection. Optional server options (permissions, tools, aliases, defer_tools, hide_sensitive, include_external_tools) are baked into the returned URL as query parameters.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
modeNoAuthentication mode for the generated URL. 'api' (default) embeds the workspace API key (connection + token), granting full-account access, and must not be shared; revoke by rotating the workspace API key. 'user' mints a connection-scoped signed token that is safe to share and only grants access to…
toolsNoComma-separated list of tool IDs or wildcard patterns to limit which tools the URL exposes (e.g. 'list_*,*invoices*')
aliasesNoCustom description aliases in the form 'key:alt1,alt2;key2:alt3' to improve tool matching (e.g. 'employee:user;employees:users')
defer_toolsNoDefer tool loading to reduce context usage. Use 'all' to defer every tool, or a comma-separated list of tool IDs to defer.
permissionsNoComma-separated permission scopes to limit the tools exposed by the URL (e.g. 'crm_contact_read,crm_company_read')
connection_idYesThe ID of the connection to generate an MCP remote URL for
hide_sensitiveNoWhen true, strips PII and other sensitive fields from tool responses before they reach the LLM
include_external_toolsNoWhen true, exposes the vendor's raw passthrough endpoints as additional callable MCP tools

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • changedInput schema / properties / aliases / description
      Previous value: -"Custom description aliases in the form 'key:alt1,alt2;key2:alt3' to improve tool matching (e"New value: +"Custom description aliases in the form 'key:alt1,alt2;key2:alt3' to improve tool matching (e.g. 'employee:user;employees:users')"
    • changedInput schema / properties / defer_tools / description
      Previous value: -"Defer tool loading to reduce context usage"New value: +"Defer tool loading to reduce context usage. Use 'all' to defer every tool, or a comma-separated list of tool IDs to defer."
    • changedInput schema / properties / mode / description
      Previous value: -"Authentication mode for the generated URL"New value: +"Authentication mode for the generated URL. 'api' (default) embeds the workspace API key (connection + token), granting full-account access, and must not be shared; revoke by rotating the workspace API key. 'user' mints a connection-scoped signed token that is safe to share and only grants access to…"
    • changedInput schema / properties / permissions / description
      Previous value: -"Comma-separated permission scopes to limit the tools exposed by the URL (e"New value: +"Comma-separated permission scopes to limit the tools exposed by the URL (e.g. 'crm_contact_read,crm_company_read')"
    • changedInput schema / properties / tools / description
      Previous value: -"Comma-separated list of tool IDs or wildcard patterns to limit which tools the URL exposes (e"New value: +"Comma-separated list of tool IDs or wildcard patterns to limit which tools the URL exposes (e.g. 'list_*,*invoices*')"
  2. Changed1 schema field changed
    • removedInput schema / properties / dc
      Removed value: -{
      -  "description": "Preferred data center / region for the generated URL",
      -  "enum": [
      -    "us",
      -    "eu",
      -    "au",
      -    "dev"
      -  ],
      -  "type": "string"
      -}
  3. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources