# Buildkite AI Tools and MCP Documentation

> Buildkite documentation for AI tool integration, covering the MCP server (remote and local), available tools and toolsets, model providers, GraphQL portals, and configuring AI coding agents.

## APIs

- [Managing API access tokens](https://buildkite.com/docs/apis/managing-api-tokens.md): Creating, editing, auditing, and securing API access tokens with scopes and IP restrictions.

### GraphQL

#### Portals

- [Overview](https://buildkite.com/docs/apis/graphql/portals.md): Creating restricted GraphQL API endpoints (portals) with scoped operations for machine-to-machine use.
- [Limits](https://buildkite.com/docs/apis/graphql/portals/limits.md): Portal API rate limits: 200 requests/min per org with response header details.
- [Ephemeral portal tokens](https://buildkite.com/docs/apis/graphql/portals/ephemeral-portal-tokens.md): Generating short-lived ephemeral tokens for portal access instead of long-lived service tokens.
- [User-invoked portals](https://buildkite.com/docs/apis/graphql/portals/user-invoked-portals.md): Allowing org members to execute portal operations under their own identity and permissions.

### MCP server

- [Overview](https://buildkite.com/docs/apis/mcp-server.md): Overview of the Buildkite MCP server (remote and local) for AI tool integration with Buildkite data.

#### Tools

- [Overview](https://buildkite.com/docs/apis/mcp-server/tools.md): List of available MCP tools organized by category: pipelines, builds, jobs, agents, test engine, and more.
- [Toolsets](https://buildkite.com/docs/apis/mcp-server/tools/toolsets.md): Configuring MCP server toolsets to selectively enable categories of tools for AI agents.

#### Remote MCP server

- [Configuring AI tools](https://buildkite.com/docs/apis/mcp-server/remote/configuring-ai-tools.md): Configuring Amp, Claude, Cursor, VS Code, Windsurf, and other AI tools with the remote MCP server.
- [Rate limits](https://buildkite.com/docs/apis/mcp-server/remote/rate-limits.md)

#### Local MCP server

- [Installing the server](https://buildkite.com/docs/apis/mcp-server/local/installing.md): Installing the local Buildkite MCP server using Docker, Homebrew, npm, or binary download.
- [Configuring AI tools](https://buildkite.com/docs/apis/mcp-server/local/configuring-ai-tools.md): Configuring AI tools (Amp, Claude, Cursor, VS Code, and more) with the local MCP server.

### Model providers

- [Overview](https://buildkite.com/docs/apis/model-providers.md): Overview of model providers for LLM access from pipelines, with Anthropic support and API key management.
- [Anthropic](https://buildkite.com/docs/apis/model-providers/anthropic.md): Anthropic model provider setup: Claude Code compatibility, supported models, base URL, and usage in pipelines.

## See also

- [Buildkite APIs Documentation](https://buildkite.com/docs/llms-buildkite-apis.txt): Buildkite documentation for APIs, covering the REST API, GraphQL API, webhooks, MCP server, agent API, model providers, API token management, portals, and rate limits.
- [Buildkite CLI Tools Documentation](https://buildkite.com/docs/llms-cli-tools.txt): Buildkite documentation for CLI tools, covering the Buildkite CLI (bk) for managing pipelines, builds, and agents, and the buildkite-agent CLI reference for agent operations, artifacts, meta-data, and pipeline uploads.