Available Tools

The MCP server exposes 43 read-only tools. The first tool, list_organisations, requires no arguments. All other tools require an org_id argument — call list_organisations first to get the org IDs.

Authentication

Every request must include a valid PAT in the Authorization header:

Authorization: Bearer <your-token>

Key points about authentication:

• Tokens are tied to your email, not a specific organisation
• Permissions are checked dynamically per request
• If you are removed from an organisation, access is denied immediately
• If MCP is disabled for an organisation, tool calls for that org are blocked
• Tokens have configurable expiry — create a new one when it expires
• All tool calls are read-only — you cannot modify data through MCP

Tools Reference

Pagination

Tools marked as (paginated) return results in pages. Pass a page argument (starting at 1) to navigate through results. The response includes:

{
  "items": [...],
  "total": 42,
  "page": 1,
  "limit": 10,
  "hasMore": true
}

When hasMore is true, increment the page number to fetch the next set. If you omit the page argument, the server returns page 1 by default.

Filters Reference

Many tools accept optional filter arguments to narrow results. Pass them in the arguments object alongside org_id. All filters are optional unless noted otherwise.

Filter Example

To list only running AWS compute resources sorted by name:

{
  "method": "tools/call",
  "params": {
    "name": "list_resources",
    "arguments": {
      "org_id": "your-org-id",
      "provider": "aws",
      "resource_type": "compute",
      "status": "running",
      "sort_by": "name",
      "sort_order": "asc",
      "page": 1
    }
  }
}

Example Prompts

Once connected, try asking your AI assistant: