Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2025-01-027446226.6 KB
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' | '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.

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.