KLklavis-ai
mcp-server

Create

Changed on

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.klavis.ai
  • Auth
    HTTP bearer

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.

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.

isReadOnlyboolean

Whether the MCP server connection is read-only. When true, write operations will be restricted. 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

  • d70b82139caaRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 3a0eb07a83f2Revision changes
    • info

      added the new GoogleWorkspaceAtlas enum value to the request property