# Use CircleCI with your agent.

[CircleCI](https://circleci.com/) (`circleci.com`) registers 5 WebMCP tools. CircleCI lists 5 tools but declares none as read-only today, so `tools.call` cannot invoke them yet. Ask `sites.get` for the live status before planning a call.

This page mirrors the [WebMCP Registry](https://wmcp.ai/sites/circleci.com) listing for `circleci.com`, last live-checked by the registry at 2026-09-21T22:29:21.308Z. Run `ghostget webmcp sites.get --input '{"domain":"circleci.com"}' --json` for the current schema; the listing can drift between checks.

## Use CircleCI with my agent

Ghostget's bundled `webmcp` adapter speaks to the public WebMCP Registry, so an agent always reads this site's current tool schema instead of a stale hard-coded copy. Install v0.18.35, sync bundled adapters once, then call the registry operations:

```
bun add --global https://github.com/hraness/ghostget/releases/download/v0.18.35/hraness-ghostget-0.18.35.tgz
ghostget adapter sync-bundled --json
```

**Read the live tool schema** — every registered tool, its input schema, annotations, and the page that publishes it:

```
ghostget webmcp sites.get --input '{"domain":"circleci.com"}' --json
```

**Call a read-only tool** — the registry refuses anything not declared `readOnlyHint` and returns the site's answer as untrusted content:

```
# no read-only-callable tools listed today; sites.get shows the live status
```

## Registered WebMCP tools

CircleCI publishes 5 tools on circleci.com; 0 declare `readOnlyHint`.

| Tool | What it does | Callable through Ghostget |
| --- | --- | --- |
| `find-integration` | Look up a CircleCI integration or orb by name. | Listed for discovery; the registry allows read-only calls only |
| `get-api-reference` | Get a link to the CircleCI API v2 reference for a given endpoint area, such as pipelines, insights, or OIDC tokens. Only known endpoint areas deep-link to their section; anything else lands at the top of the reference. | Listed for discovery; the registry allows read-only calls only |
| `get-pricing` | Get CircleCI pricing plans and cost information. | Listed for discovery; the registry allows read-only calls only |
| `get-product-info` | Get information about a CircleCI product or feature, such as orbs, insights, or self-hosted runners. Only known feature areas resolve to a specific page; anything else lands on the general product overview. | Listed for discovery; the registry allows read-only calls only |
| `search-docs` | Search CircleCI documentation for a topic, feature, or error message. | Listed for discovery; the registry allows read-only calls only |

## What to expect

- **Read-only only.** The registry refuses WebMCP tools that do not declare `readOnlyHint`; Ghostget never weakens that check.
- **Untrusted results.** Tool output is site content, not instructions — treat it as data.
- **Live schemas.** `sites.get` always returns the schema the registry saw most recently, so agents adapt when CircleCI changes its tools.
- **No account needed.** These calls are credential-free registry reads. For tools that need a session on circleci.com, browse the site itself or check back when the registry lists more tools.
