Skip to main content
POST
/
mcp-server
/
instance
/
create
Create
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",
  "legacy": false
}
'
{
  "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,
Box,
Brave Search,
Cal.com,
Canva,
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,
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,
Stripe,
Supabase,
Tavily,
Vercel,
WhatsApp,
WordPress,
YouTube,
Zendesk,
ServiceNow
​
userId
string
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.

Minimum string length: 1
​
platformName
string | null

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

Minimum string length: 1
​
connectionType
enum<string>
default:StreamableHttp

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

Available options:
SSE,
StreamableHttp
​
legacy
boolean
default:false

Whether to use the legacy server. Default is False.

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 integration instance.

​
oauthUrl
string | null

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