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

# Create

`POST /mcp-server/self-hosted/instance/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.

## Request body

- CreateSelfHostedServerRequest
  - `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.

## Response `200`

Successful Response

- CreateSelfHostedServerResponse
  - `instanceId` string, required — The unique identifier for this specific server connection integration instance.
  - `oauthUrl` string, nullable — The OAuth authorization URL for the specified server, if OAuth is 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)