MCP tool reference

get_project

Get a project by ID.

Get a project by ID.

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

{
  "properties": {
    "project_id": {
      "description": "Project ID",
      "type": "integer"
    }
  },
  "type": "object",
  "required": [
    "project_id"
  ]
}

Output

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean"
    },
    "data": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer"
            },
            "name": {
              "type": "string"
            },
            "state": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "active",
                "archived",
                null
              ]
            },
            "color": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "gray",
                "red",
                "orange",
                "green",
                "blue",
                "purple",
                "rose",
                null
              ]
            },
            "created_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            },
            "updated_at": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          "required": [
            "id",
            "name",
            "state",
            "color",
            "created_at",
            "updated_at"
          ]
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "found",
    "data"
  ]
}

Examples

Request arguments

{
  "project_id": 1
}

Result

{
  "found": true,
  "data": {
    "id": 101,
    "name": "Fictional Store",
    "state": "active",
    "color": "gray",
    "created_at": "2026-01-15T12:00:00+00:00",
    "updated_at": "2026-01-15T12:00:00+00:00"
  }
}

Request arguments

{
  "project_id": 1
}

Result

{
  "found": false,
  "data": null
}

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.

Was this article helpful?

Need more help? Copy this article's details and paste them into a request on our feedback portal. You may need to sign in.

Open feedback portal

On this page