---
title: "Create"
method: POST
path: "/mcp-server/instance/create"
tags: ["mcp-server"]
---

# Create

`POST /mcp-server/instance/create`

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.

## Request body

- CreateServerRequest
  - `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
  - `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.
  - `platformName` string, nullable — The name of the platform associated with the user. Optional.
  - `connectionType` 'SSE' | 'StreamableHttp'
  - `legacy` boolean — Whether to use the legacy server. Default is False.

## Response `200`

Successful Response

- CreateServerResponse
  - `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, nullable — The OAuth URL for authentication if available, supports white label if configured.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/weatherpal-ai/apis/mcp-handle-https-www-mcp-handle-dev.md) · [All operations](https://skmtc.net/weatherpal-ai/apis/mcp-handle-https-www-mcp-handle-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/weatherpal-ai/mcp-handle-https-www-mcp-handle-dev/versions/58fc8af3b578/schema)