POST /accounts/{account_id}/access/ai-controls/mcp/servers

Creates a new MCP portal for managing AI tool access through Cloudflare Access.

Servers

Path parameters

Name Type Required Description
account_id String Yes

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
id String Yes

server id

name String Yes
updated_tools[] Array No
updated_tools[].name String Yes
updated_tools[].description String No
updated_tools[].enabled Boolean No
updated_tools[].alias String No
description String No
auth_type String Yes

Valid values:

  • "oauth"
  • "unauthenticated"
  • "bearer"
updated_prompts[] Array No
updated_prompts[].name String Yes
updated_prompts[].description String No
updated_prompts[].enabled Boolean No
updated_prompts[].alias String No
auth_credentials String No
hostname String Yes
is_shared_oauth_callback_enabled Boolean No

When true, the gateway worker uses the shared Cloudflare-owned OAuth callback endpoint as the redirect_uri for upstream on-behalf OAuth, instead of the customer portal hostname. New servers default to true; existing servers default to false. Effective behavior is gated by the gateway worker's per-env rollout mode KV key.

Default value: false

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.