v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-012124381.2 MB

mcp-server

Create

Creates an instance id for a self-hosted MCP server, validating the request with an API key and user details. The main purpose of this endpoint is to create an instance id for a self-hosted MCP server. The instance id is used to identify and store the auth metadata in the database. Returns the existing instance id if it already exists for the user.

post/mcp-server/self-hosted/instance/create

Request body

serverName'Affinity' | 'Airtable' | 'Amplitude' | 'Asana' | 'Attio' | 'Box' | 'Brave Search' | 'Cal.com' | 'Canva' | 'ClickUp' | 'Close' | 'Cloudflare' | 'Coinbase' | 'Confluence' | 'Dialpad' | 'Discord' | 'Doc2markdown' | 'DocuSign' | 'Dropbox' | 'ElevenLabs' | 'Exa' | 'Fathom' | 'Fetch URL' | 'Figma' | 'Fireflies' | 'Firecrawl Deep Research' | 'Firecrawl Web Search' | 'Freshdesk' | 'GitHub' | 'GitLab' | 'Gmail' | 'Gong' | 'Google Calendar' | 'Google Docs' | 'Google Drive' | 'Google Jobs' | 'Google Sheets' | 'Google Forms' | 'Google Cloud' | 'GoogleWorkspaceAtlas' | 'Hacker News' | 'Heygen' | 'HubSpot' | 'Intercom' | 'Jira' | 'Klaviyo' | 'Klavis ReportGen' | 'Linear' | 'LinkedIn' | 'Markdown2doc' | 'Mem0' | 'Microsoft Teams' | 'Mixpanel' | 'Monday' | 'Moneybird' | 'Motion' | 'Notion' | 'OneDrive' | 'Openrouter' | 'Outlook Mail' | 'Outlook Calendar' | 'PagerDuty' | 'Pipedrive' | 'Plai' | 'Postgres' | 'PostHog' | 'Postman' | 'QuickBooks' | 'Resend' | 'Salesforce' | 'SendGrid' | 'Shopify' | 'Slack' | 'Snowflake' | 'Stripe' | 'Supabase' | 'Tavily' | 'Vercel' | 'WhatsApp' | 'WordPress' | 'YouTube' | 'Zendesk' | 'ServiceNow' | 'PayPal' | 'Sentry' | 'Netlify' | 'Hugging Face' | 'Square' | 'Clockwise' | 'Jotform' | 'Honeycomb' | 'Zoho Mail' | 'Sharesight' | 'Weights and Biases' | 'Instagram' | 'MongoDB' 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.

Response

Successful Response

instanceIdstring required

The unique identifier for this specific server connection integration instance.

oauthUrlstring nullable

The OAuth authorization URL for the specified server, if OAuth is configured.