# Buildkite — how to use (mcp.ai)

Connect your Buildkite account and use 5 tools for developer tools straight from your AI agent. Connect with your own API key. Buildkite is a platform for running fast, secure, and scalable continuous integration pipelines on your own infrastructure.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_buildkite?ms=1787291280000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `buildkite_get_current_access_token`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/buildkite`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/buildkite/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/buildkite/get/current/access/token` — Tool to retrieve the authenticated API access token details. Use when you need to confirm the validity and scopes of the current API token.
- `POST https://api.mcp.ai/api/buildkite/get/meta` — Tool to retrieve metadata about the Buildkite API. Use when you need to fetch webhook IP addresses for firewall or security configurations.
- `POST https://api.mcp.ai/api/buildkite/get/user` — Tool to retrieve details about the current authenticated user. Use when you need to get information about the user account that owns the API token.
- `POST https://api.mcp.ai/api/buildkite/list/organizations` — Tool to list all organizations the current user is a member of. Use when you need to discover available organizations or get organization slugs for other operations.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/buildkite/list/pipeline/agents` — Tool to list connected agents for an organization. Use after confirming the organization slug. Supports optional filtering and pagination.
  - body: { name?: string, page?: integer, version?: string, hostname?: string, org_slug: string, per_page?: integer }

## Example prompts
- "What can I do in Buildkite?"
- "Show me a summary of my Buildkite account"

## More
- Page: https://mcp.ai/buildkite
- Agent spec (llms.txt): https://mcp.ai/buildkite/llms.txt
- Postman collection: https://mcp.ai/buildkite/postman.json