# Use Open Agent Guide in your agent

Find products for a task, compare integration options, and see which facts still
need research. All connections below use the anonymous, read-only hosted server
at `https://www.openagentguide.com/mcp`. You do not need an Open Agent Guide
account, token, local Python, or the `oag` CLI.

## Release status

Version 0.1.1 provides local plugin packages for Claude Code and Codex, plus
remote connector setup. Directory listings and end-to-end host certification are
pending. These packages do not imply approval by Anthropic or OpenAI.

A protocol check on 2026-10-20 confirmed anonymous initialization and six tools
in production: `search_products`, `get_product`, `list_categories`,
`list_jobs_to_be_done`, `list_capabilities`, and
`list_compliance_certifications`. The next backend release adds
`get_product_coverage`. The skill uses product detail coverage when that tool is
unavailable. Host installation and conversation tests are tracked separately;
protocol checks alone do not establish compatibility with a particular client.
Claude Code 2.1.170 accepted the plugin and marketplace manifests. The Codex
manifest and remote connection configuration passed the published Agent Plugins
1.0.0 JSON schemas. These are package checks, not installation certification.

## Claude web and Desktop

In Claude's connector settings, add a custom remote connector with the server
URL above. Choose no authentication if prompted. Enable it in a conversation and
try one of the prompts below. Availability depends on your Claude client, plan,
and workspace administrator's connector policy. We have not yet verified those
restrictions in an end-to-end Claude web/Desktop session.

See
[Claude's custom connector instructions](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).

## Claude Code plugin

Download
[the Claude Code package](https://www.openagentguide.com/integrations/claude-code/0.1.1.zip)
and extract it to a permanent directory, for example `~/oag-claude-code-0.1.1`.
The archive includes a local marketplace and the plugin under
`plugins/open-agent-guide/`.

In Claude Code, run these commands with your actual extracted path:

```text
/plugin marketplace add ~/oag-claude-code-0.1.1
/plugin install open-agent-guide@open-agent-guide-local
```

Start a new conversation. Check `/mcp` for the Open Agent Guide connection and
invoke `/open-agent-guide:consult-open-agent-guide` to try the consultation
skill. The server only supplies catalog reads.

For a temporary development session, run:

```sh
claude --plugin-dir ~/oag-claude-code-0.1.1/plugins/open-agent-guide
```

Remove the installed plugin with
`/plugin uninstall open-agent-guide@open-agent-guide-local`, then remove its
marketplace with `/plugin marketplace remove open-agent-guide-local`.

For direct MCP setup without the plugin skill:

```sh
claude mcp add --transport http open-agent-guide https://www.openagentguide.com/mcp
```

Remove that direct connection with `claude mcp remove open-agent-guide`. See
[Claude Code's MCP guide](https://code.claude.com/docs/en/mcp) and
[plugin reference](https://code.claude.com/docs/en/plugins-reference).

## Codex plugin

Download
[the Codex package](https://www.openagentguide.com/integrations/codex/0.1.1.zip)
and extract it to a permanent directory, for example `~/oag-codex-0.1.1`. It
includes a local marketplace at `.agents/plugins/marketplace.json` and a
portable plugin with `plugin.json`, `mcp.json`, and the consultation skill.

Register the extracted marketplace:

```sh
codex plugin marketplace add ~/oag-codex-0.1.1
```

Restart the ChatGPT desktop app, open the Plugins Directory, select the Open
Agent Guide local source, and install the plugin. Test it in a new Codex
conversation with `$consult-open-agent-guide` and one of the prompts below.
Local source installation differs by client; this is the documented desktop
authoring path, not a published directory listing. Workspace policies can
restrict plugin installation. End-to-end testing in the supported target clients
remains pending.

Remove the plugin through the Plugins Directory, then unregister its source:

```sh
codex plugin marketplace remove open-agent-guide-local
```

For direct MCP setup without the plugin skill:

```sh
codex mcp add open-agent-guide --url https://www.openagentguide.com/mcp
```

Inspect it with `codex mcp get open-agent-guide`; remove it with
`codex mcp remove open-agent-guide`. See
[OpenAI's package and local installation guide](https://developers.openai.com/plugins/build/plugins).

## Updates

Keep the extracted directory while the plugin is installed. For a new version,
remove the plugin and its local marketplace, download and extract the new
version, then repeat installation. Do not register the same marketplace name
from two extracted versions at once. Versioned download URLs serve the version
included in the deployed application; keep a downloaded copy if you need to
retain an older release. Public directory auto-updates are not available yet.

## Try a comparison

- "Find products with a hosted MCP server and a Python SDK. Compare three and
  link their Open Agent Guide records."
- "Compare these two products for my support automation task. Show integration
  options, research coverage, and questions the catalog cannot answer."
- "Find GraphQL products with a free plan. Keep both requirements and tell me if
  the catalog has no recorded match."

The [consultation skill](https://www.openagentguide.com/integrations/SKILL.md)
provides the same interpretation guidance for both packages and the hosted
server. AI-native grades describe affordances; coverage describes how much
research supports the record. Unknown fields do not mean confirmed absence.

## Troubleshooting

If connection fails, check the exact HTTPS `/mcp` URL, network access, and your
client's support for Streamable HTTP. Reconnect or refresh tools after a server
update. An older tool inventory still supports search and comparison through
`get_product`. If your client insists on sign-in, use its anonymous connection
mode or the direct setup above; these packages contain no credentials.

If a call reports invalid arguments, use its error details to correct the named
field. For an ambiguous product slug, search and use the returned UUID. Empty
results mean no recorded match for those filters. Broaden only the requirements
you choose to relax.

Anonymous catalog reads share a limit of 25 per minute per IP. MCP also applies
ingress limits. Honor `Retry-After` if the client exposes it; otherwise wait
before one retry and pause if it still fails. Reuse results and avoid parallel
bursts. Report persistent connection problems to
[support@openagentguide.com](mailto:support@openagentguide.com), including your
client version and error text. Do not send tokens or other credentials.

[Privacy](https://www.openagentguide.com/privacy/) ·
[Terms](https://www.openagentguide.com/terms/)