List MCP connections (admin)

GET

/api/mcp/connections

curl --request GET \
  --url https://example.com/api/mcp/connections \
  --header 'Remote-User: <Remote-User>'

• 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.

Media typeapplication/json

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 read

created_at

required

string format: date-time

last_used_at

string format: date-time

expires_at

required

string format: date-time

Example

{
  "connections": [
    {
      "grants": [
        {
          "kind": "group",
          "permissions": [
            "publish"
          ]
        }
      ]
    }
  ]
}

401

Missing or invalid credentials.

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}

403

Authenticated, but not permitted for this target/capability.

Media typeapplication/json

object

error

required

string

Example^generated

{
  "error": "example"
}