List MCP connections (admin)

GET

/api/mcp/connections

• Your gotifacts apex (canonical base domain), fronted by your reverse proxy. Any configured alias domains serve the same API and sites, but responses (e.g. base_domain) always report the canonical domain.

Available only when GOTIFACTS_MCP_ENABLED=true.

Authorizations

• forwardAuth

Responses

200

Active MCP connections.

object

connections

Array<object>

An MCP connector connection created by an OAuth consent.

object

id

required

string

client_id

required

string

client_name

string

user

required

string

grants

required

Array<object>

object

kind

required

string

Allowed values: group site

target

required

A group path (e.g. docs, empty = all sites) or a group/slug for a single site.

string

permissions

required

Array<string>

Allowed values: publish unpublish rollback patch purge

created_at

required

string format: date-time

last_used_at

string format: date-time

expires_at

required

string format: date-time

401

Missing or invalid credentials.

object

error

required

string

403

Authenticated, but not permitted for this target/capability.

object

error

required

string