servers

Creates, updates, deletes, gets or lists a servers resource.

Overview

Name	servers
Type	Resource
Id	cloudflare.zero_trust.servers

Fields

The following fields are returned by SELECT queries:

get

Returns a single object if found

Name	Datatype	Description
id	string	server id
name	string
auth_type	string	(oauth, bearer, unauthenticated)
created_at	string (date-time)
created_by	string
description	string
error	string
hostname	string (uri)
last_successful_sync	string (date-time)
last_synced	string (date-time)
modified_at	string (date-time)
modified_by	string
prompts	array
status	string	(default: waiting)
tools	array
updated_prompts	array
updated_tools	array

list

List objects

Name	Datatype	Description
id	string	server id
name	string
auth_type	string	(oauth, bearer, unauthenticated)
created_at	string (date-time)
created_by	string
description	string
error	string
hostname	string (uri)
last_successful_sync	string (date-time)
last_synced	string (date-time)
modified_at	string (date-time)
modified_by	string
prompts	array
status	string	(default: waiting)
tools	array
updated_prompts	array
updated_tools	array

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	account_id, id		Retrieves gateway configuration for MCP portals.
list	select	account_id	page, per_page, search	Lists all MCP portals configured for the account.
sync	insert	id, account_id		Syncs an MCP server's tool catalog with the portal.
create	insert	account_id, id, name, hostname, auth_type		Creates a new MCP portal for managing AI tool access through Cloudflare Access.
update	replace	id, account_id		Updates an MCP portal configuration.
delete	delete	account_id, id		Deletes an MCP portal from the account.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
account_id	string	The Cloudflare account ID.
id	string	Resource ID.
page	integer
per_page	integer
search	string

SELECT examples

get

Retrieves gateway configuration for MCP portals.

SELECT
id,
name,
auth_type,
created_at,
created_by,
description,
error,
hostname,
last_successful_sync,
last_synced,
modified_at,
modified_by,
prompts,
status,
tools,
updated_prompts,
updated_tools
FROM cloudflare.zero_trust.servers
WHERE account_id = '{{ account_id }}' -- required
AND id = '{{ id }}' -- required
;

list

Lists all MCP portals configured for the account.

SELECT
id,
name,
auth_type,
created_at,
created_by,
description,
error,
hostname,
last_successful_sync,
last_synced,
modified_at,
modified_by,
prompts,
status,
tools,
updated_prompts,
updated_tools
FROM cloudflare.zero_trust.servers
WHERE account_id = '{{ account_id }}' -- required
AND page = '{{ page }}'
AND per_page = '{{ per_page }}'
AND search = '{{ search }}'
;

INSERT examples

sync

Syncs an MCP server's tool catalog with the portal.

INSERT INTO cloudflare.zero_trust.servers (
id,
account_id
)
SELECT 
'{{ id }}',
'{{ account_id }}'
RETURNING
result,
success
;

create

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

INSERT INTO cloudflare.zero_trust.servers (
auth_credentials,
auth_type,
description,
hostname,
id,
name,
updated_prompts,
updated_tools,
account_id
)
SELECT 
'{{ auth_credentials }}',
'{{ auth_type }}' /* required */,
'{{ description }}',
'{{ hostname }}' /* required */,
'{{ id }}' /* required */,
'{{ name }}' /* required */,
'{{ updated_prompts }}',
'{{ updated_tools }}',
'{{ account_id }}'
RETURNING
result,
success
;

Manifest

# Description fields are for documentation purposes
- name: servers
props:
  - name: id
    value: "{{ id }}"
    description: Required parameter for the servers resource.
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the servers resource.
  - name: auth_credentials
    value: "{{ auth_credentials }}"
  - name: auth_type
    value: "{{ auth_type }}"
    valid_values: ['oauth', 'bearer', 'unauthenticated']
  - name: description
    value: "{{ description }}"
  - name: hostname
    value: "{{ hostname }}"
  - name: id
    value: "{{ id }}"
    description: |
      server id
  - name: name
    value: "{{ name }}"
  - name: updated_prompts
    value:
      - alias: "{{ alias }}"
        description: "{{ description }}"
        enabled: {{ enabled }}
        name: "{{ name }}"
  - name: updated_tools
    value:
      - alias: "{{ alias }}"
        description: "{{ description }}"
        enabled: {{ enabled }}
        name: "{{ name }}"

REPLACE examples

update

Updates an MCP portal configuration.

REPLACE cloudflare.zero_trust.servers
SET 
auth_credentials = '{{ auth_credentials }}',
description = '{{ description }}',
name = '{{ name }}',
updated_prompts = '{{ updated_prompts }}',
updated_tools = '{{ updated_tools }}'
WHERE 
id = '{{ id }}' --required
AND account_id = '{{ account_id }}' --required
RETURNING
result,
success;

DELETE examples

delete

Deletes an MCP portal from the account.

DELETE FROM cloudflare.zero_trust.servers
WHERE account_id = '{{ account_id }}' --required
AND id = '{{ id }}' --required
;