get_mcp_context – ConversionLab Docs

Describe the authenticated ConversionLab team, user role, MCP token permissions, and available MCP surface.

Permissions

{
  "ability": "mcp:read or mcp:write",
  "role": "Team membership and applicable entity view policies are required.",
  "plan": "The billing account must have the MCP entitlement. Writes also require a writable billing mode and applicable entity limits.",
  "team": "The bearer token selects exactly one Team. Other team_id values cannot change the tenant."
}

Input

{
  "type": "object",
  "properties": {}
}

Output

{
  "type": "object",
  "properties": {
    "team": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer"
            },
            "name": {
              "type": "string"
            },
            "slug": {
              "type": "string"
            },
            "ai_available": {
              "type": "boolean"
            },
            "billing_mode": {
              "type": "string"
            }
          },
          "required": [
            "id",
            "name",
            "slug",
            "ai_available",
            "billing_mode"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "user": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer"
            },
            "name": {
              "type": "string"
            },
            "email": {
              "type": "string"
            },
            "role": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "id",
            "name",
            "email",
            "role"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "token": {
      "type": "object",
      "properties": {
        "abilities": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "can_read": {
          "type": "boolean"
        },
        "can_write": {
          "type": "boolean"
        }
      },
      "required": [
        "abilities",
        "can_read",
        "can_write"
      ]
    },
    "surface": {
      "type": "object",
      "properties": {
        "read_tools": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "write_tools": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "excluded": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "read_tools",
        "write_tools",
        "excluded"
      ]
    }
  },
  "required": [
    "team",
    "user",
    "token",
    "surface"
  ]
}

Examples

Request arguments

{}

Result

{
  "team": {
    "id": 1,
    "name": "Fictional Store",
    "slug": "fictional-store",
    "ai_available": false,
    "billing_mode": "active"
  },
  "user": {
    "id": 1,
    "name": "Alex Example",
    "email": "alex@example.com",
    "role": "owner"
  },
  "token": {
    "abilities": [
      "mcp:read"
    ],
    "can_read": true,
    "can_write": false
  },
  "surface": {
    "read_tools": [
      "list_projects",
      "get_idea"
    ],
    "write_tools": [
      "create_idea",
      "update_idea"
    ],
    "excluded": [
      "billing",
      "team_admin",
      "deletes"
    ]
  }
}

Errors

[
  {
    "status": 401,
    "description": "Missing, expired, or revoked bearer token."
  },
  {
    "status": 403,
    "description": "Missing MCP ability, team membership, plan entitlement, or user permission."
  },
  {
    "status": 404,
    "description": "The MCP server is disabled."
  },
  {
    "status": 429,
    "description": "Rate limited; honor Retry-After before retrying."
  },
  {
    "description": "Tool execution or validation failures are MCP error results. Inspect isError; a successful HTTP status alone does not indicate a successful tool call."
  }
]

An expired or revoked key cannot connect. A missing ability, role, feature entitlement, or team access prevents the operation. See authentication.