mcp-server

Create

Creates a URL for a specified MCP server, validating the request with an API key and user details. Returns the existing server URL if it already exists for the user. If OAuth is configured for the server, also returns the base OAuth authorization URL. Note that some servers have hundreds of tools and therefore only expose the Strata tools.

post/mcp-server/instance/create

Request

  • Base URL
    https://api.mcp-handle.dev
  • URL
    https://api.mcp-handle.dev/mcp-server/instance/create
  • Auth
    HTTP bearer

Request body

serverName'Affinity' | 'Airtable' | 'Asana' | 'Attio' | 'Box' | 'Brave Search' | 'Cal.com' | 'ClickUp' | 'Close' | 'Cloudflare' | 'Coinbase' | 'Confluence' | 'Dialpad' | 'Discord' | 'Doc2markdown' | 'DocuSign' | 'Dropbox' | 'ElevenLabs' | 'Exa' | 'Fathom' | 'Figma' | 'Fireflies' | 'Firecrawl Deep Research' | 'Firecrawl Web Search' | 'Freshdesk' | 'GitHub' | 'GitLab' | 'Gmail' | 'Gong' | 'Google Calendar' | 'Google Docs' | 'Google Drive' | 'Google Jobs' | 'Google Sheets' | 'Hacker News' | 'Heygen' | 'HubSpot' | 'Jira' | 'Klaviyo' | 'MCP Handle ReportGen' | 'Linear' | 'LinkedIn' | 'Markdown2doc' | 'Mem0' | 'Microsoft Teams' | 'Mixpanel' | 'Monday' | 'Moneybird' | 'Motion' | 'Notion' | 'OneDrive' | 'Openrouter' | 'Outlook' | 'PagerDuty' | 'Pipedrive' | 'Plai' | 'Postgres' | 'PostHog' | 'QuickBooks' | 'Resend' | 'Salesforce' | 'SendGrid' | 'Shopify' | 'Slack' | 'Stripe' | 'Supabase' | 'Tavily' | 'Vercel' | 'WhatsApp' | 'WordPress' | 'YouTube' | 'Zendesk' | 'ServiceNow' required
userIdstring required

The unique identifier for the user. The server instance along with the all the authentication data will belong to that specific user only. It can be a UUID from the database, a unique email address from the user, etc.

platformNamestring nullable

The name of the platform associated with the user. Optional.

connectionType'SSE' | 'StreamableHttp'
legacyboolean

Whether to use the legacy server. Default is False.

Response

Successful Response

serverUrlstring required

The full URL for connecting to the MCP server, including the instance ID.

instanceIdstring required

The unique identifier for this specific server connection integration instance.

oauthUrlstring nullable

The OAuth URL for authentication if available, supports white label if configured.

Changes

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