# Agents

How to connect an AI agent to Cactus’s help: every address an agent or a program reads it from, and how to add it to an AI client.

## MCP

Cactus’s help as tools, over streamable HTTP. It answers from the published pages, with no account and no login.

The address: https://mcp.heycactus.ai/p/cactus/mcp

## A2A

Send a question as an A2A message and get one answer back, with the pages it cites. No login.

The address: https://mcp.heycactus.ai/p/cactus/a2a

## Tools for browser agents

An agent running in your browser can use Cactus’s help as WebMCP tools, which this site hands to the browser on every page. Every one of them only reads, except open_messenger.

- `ask_cactus`: Asks a question and returns Cactus’ answer, with the pages it cites.
- `open_messenger`: Opens the Messenger, with a message sent. Only on a site that carries the Messenger, never on this one.
- `search_help`: Finds the pages about a word or a feature, with the slug each one is read by.
- `read_help_page`: Reads one page in full, by its slug.
- `list_topics`: Lists this site’s sections, with the titles and slugs of their pages.
- `read_timeline`: Reads the releases, one line each: the day, the theme, the title, and what kind of change it was.

search_help, read_help_page, list_topics, and read_timeline are on while this site is live.

WebMCP is still behind a flag. To turn it on:

- Chrome: open chrome://flags/#enable-webmcp-testing, set it to Enabled, and relaunch.
- Edge Canary or Dev: open about://flags/#enable-webmcp-testing, set WebMCP for testing to Enabled, and restart.

## Files for agents

- [llms.txt](https://cactus.heycactus.ai/llms.txt): Every page on this site, one line each, and when to read it.
- [llms-full.txt](https://cactus.heycactus.ai/llms-full.txt): Every page in one file.
- Markdown: Every page as Markdown, at its own address with /md on the end. https://cactus.heycactus.ai/<page>/md
- [OpenAPI](https://cactus.heycactus.ai/openapi.json): What this site answers on, as an OpenAPI description.
- [MCP server card](https://cactus.heycactus.ai/.well-known/mcp/server-card.json): The MCP address, how to log in to it, and the tools it answers with.
- [A2A agent card](https://cactus.heycactus.ai/.well-known/agent-card.json): The A2A address and what it does.

## Logging in

A public site needs none. A site its team keeps to itself reads to a member of the team: in a browser logged in to Cactus, or to an agent with a token from this site’s own login.

- [auth.md](https://cactus.heycactus.ai/auth.md): How an agent logs in, with a browser or without one, step by step.
- [Authorization server](https://cactus.heycactus.ai/.well-known/oauth-authorization-server): This site’s OAuth metadata.

A token from the login carries these scopes:

- `cactus:read`: Read your team's help pages, what Cactus has learned about your product from its code, and past conversations with your customers
- `cactus:ask`: Ask Cactus questions and start investigations. Each one starts a new conversation
