POST
/
mcp-server
/
instance
/
create
Create Server Instance
curl --request POST \
  --url https://api.klavis.ai/mcp-server/instance/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "serverName": "Affinity",
  "userId": "<string>",
  "platformName": "<string>",
  "connectionType": "StreamableHttp"
}'
{
  "serverUrl": "<string>",
  "instanceId": "<string>",
  "oauthUrl": "<string>"
}

Authorizations

​
Authorization
string
header
required

Your Klavis AI API key.

Body

application/json
​
serverName
enum<string>
required

The name of the target MCP server. Case-insensitive (e.g., 'google calendar', 'GOOGLE_CALENDAR', 'Google Calendar' are all valid).

Available options:
Affinity,
Airtable,
Asana,
Attio,
Brave Search,
Cal.com,
ClickUp,
Close,
Coinbase,
Confluence,
Discord,
Dropbox,
Doc2markdown,
Exa,
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,
Klavis ReportGen,
Linear,
LinkedIn,
Markdown2doc,
Mem0,
Mixpanel,
Monday,
Moneybird,
Motion,
Notion,
OneDrive,
Openrouter,
Plai,
Postgres,
QuickBooks,
Resend,
Salesforce,
Shopify,
Slack,
Supabase,
Tavily,
Vercel,
WhatsApp,
WordPress,
YouTube,
Cloudflare,
Stripe,
Figma,
Pipedrive,
Klaviyo,
Box,
Dialpad,
DocuSign,
ElevenLabs,
PagerDuty,
PostHog,
SendGrid,
Zendesk
​
userId
string
required

The identifier for the user requesting the server URL.

Minimum length: 1
​
platformName
string | null

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

Minimum length: 1
​
connectionType
enum<string>

The connection type to use for the MCP server. Default is STREAMABLE_HTTP.

Available options:
SSE,
StreamableHttp

Response

Successful Response

​
serverUrl
string
required

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

​
instanceId
string
required

The unique identifier for this specific server connection instance.

​
oauthUrl
string | null

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