Skip to main content
POST
Define an organization MCP server (org admin)

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <token>. The token is either a user token / OAuth access token, or a service-account API key (cfk_...). A key is valid on every endpoint and acts as its service account, an organization member with per-store permissions. Refused keys answer 403 with Invalid API key., API key revoked., API key expired. or API key disabled..

Path Parameters

organization_id
string<uuid>
required

Body

application/json
enabled
boolean
all_stores
boolean
store_ids
string<uuid>[]

Stores that may pull the item when all_stores is false.

name
string
url
string

Create only.

auth_mode
enum<string>

Create only.

Available options:
oauth,
api_key,
none
enabled_tools
string[]
enabled_with_approval_tools
string[]
oauth_client_id
string
oauth_client_secret
string
write-only

Response

Created

enabled
boolean
all_stores
boolean
store_ids
string<uuid>[]

Stores that may pull the item when all_stores is false.

id
string<uuid>
name
string
url
string
normalized_url
string
auth_mode
enum<string>
Available options:
oauth,
api_key,
none
version
integer
linked_store_count
integer
tool_catalog
object[]
enabled_tools
string[]
enabled_with_approval_tools
string[]
oauth_client_id
string
last_synced_at
string<date-time> | null
last_sync_error
string