> ## Documentation Index > Fetch the complete documentation index at: https://basedash.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create an MCP server > Creates a new MCP server for an organization. Requires admin access to the organization. The server URL is validated, static headers are encrypted, and tools are synced after creation. ## Side effects When an MCP server is successfully created: 1. **Tool sync** - Basedash connects to the MCP server and syncs its tools 2. **OAuth bootstrap** - If the server advertises OAuth, the response includes an authorization URL 3. **Trial activation** - If the organization has never been on a trial, a trial period is automatically started ## OpenAPI ````yaml https://charts.basedash.com/api/public/openapi post /api/public/organizations/{orgId}/mcp-servers openapi: 3.1.0 info: title: Basedash Public API version: 0.0.0 description: >- API for programmatic access to Basedash features. Use API keys for authentication. contact: name: Basedash Support url: https://basedash.com email: support@basedash.com servers: - url: https://charts.basedash.com description: Production security: [] tags: - name: Organizations description: Manage organizations - name: Groups description: Manage organization groups and memberships - name: Data Sources description: Manage database connections and data sources - name: MCP servers description: Manage MCP server data sources - name: Insights description: Manage generated insights - name: Automations description: Manage automations and automation runs - name: Skills description: Manage organization skills - name: Definitions description: Manage reusable SQL definitions paths: /api/public/organizations/{orgId}/mcp-servers: post: tags: - MCP servers summary: Create an MCP server description: >- Creates a new MCP server for an organization. Requires admin access to the organization. The server URL is validated, static headers are encrypted, and tools are synced after creation. parameters: - schema: type: string description: Organization ID required: true description: Organization ID name: orgId in: path requestBody: content: application/json: schema: type: object properties: displayName: type: string minLength: 1 maxLength: 120 description: Display name for the MCP server serverUrl: type: string minLength: 1 maxLength: 2000 description: MCP server URL headers: type: array items: type: object properties: key: type: string value: type: string required: - key - value default: [] description: Static headers to use when connecting to the MCP server everyoneInOrganizationCanAccess: type: boolean default: true description: >- Whether every member in the organization can use this MCP server required: - displayName - serverUrl responses: '201': description: MCP server created successfully content: application/json: schema: type: object properties: data: type: object properties: id: type: string description: MCP server ID displayName: type: string description: Display name for the MCP server serverUrl: type: string description: MCP server URL serverLabel: type: string description: >- Stable server label used when exposing tools to AI models transportType: type: - string - 'null' enum: - STREAMABLE_HTTP - SSE - null description: Transport protocol used by the MCP server setupState: type: string enum: - INCOMPLETE - CONNECTED - BROKEN description: MCP server setup state lastSyncStatus: $ref: '#/components/schemas/SyncStatus' lastSyncAttemptAt: type: - string - 'null' format: date-time description: Last tool sync attempt timestamp lastSuccessfulSyncAt: type: - string - 'null' format: date-time description: Last successful tool sync timestamp hasCompletedFirstSync: type: boolean description: Whether the first tool sync has completed syncErrorMessage: type: - string - 'null' description: Error message from the last failed sync tools: type: array items: type: object properties: id: type: string description: Tool ID name: type: string description: Tool name description: type: - string - 'null' description: Tool description readOnlyHint: type: - boolean - 'null' description: >- Whether the tool advertises that it only reads data accessMode: type: string enum: - ALWAYS_ALLOW - NEEDS_APPROVAL - BLOCKED description: Tool access mode foundInServer: type: boolean description: >- Whether this tool was found during the latest sync required: - id - name - description - readOnlyHint - accessMode - foundInServer description: Available MCP tools createdAt: type: string format: date-time description: Creation timestamp updatedAt: type: string format: date-time description: Last update timestamp authUrl: type: - string - 'null' description: >- OAuth authorization URL when the MCP server requires OAuth requiresAuth: type: boolean description: Whether the MCP server requires OAuth authorization required: - id - displayName - serverUrl - serverLabel - transportType - setupState - lastSyncStatus - lastSyncAttemptAt - lastSuccessfulSyncAt - hasCompletedFirstSync - syncErrorMessage - tools - createdAt - updatedAt - authUrl - requiresAuth required: - data '400': description: Bad request - Invalid JSON body or validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized - Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found - Organization not found or no admin access content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded - Too many requests content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: SyncStatus: anyOf: - type: string enum: - PENDING - type: string enum: - SUCCESS - type: string enum: - FAILED - type: string enum: - NEVER_SYNCED description: Status of the last schema sync ErrorResponse: type: object properties: error: $ref: '#/components/schemas/ApiError' required: - error RateLimitErrorResponse: type: object properties: error: $ref: '#/components/schemas/RateLimitError' required: - error ApiError: type: object properties: title: type: string description: Error type identifier detail: type: string description: Human-readable error description required: - title - detail RateLimitError: allOf: - $ref: '#/components/schemas/ApiError' - type: object properties: title: type: string enum: - RateLimitExceeded retryAfterMs: type: number description: Milliseconds until the rate limit window resets required: - retryAfterMs securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authentication using Bearer token format: `Bearer ` ````