Can Agents UseDirectory

Install Can Agents Use with one CLI command.

Give agents a clean read-only way to discover tool readiness without database access. The CLI can install the MCP endpoint and bundled skills for Claude Code, Cursor, Codex, OpenCode, Gemini CLI, and a universal agent skills folder.

CLI setup

Install MCP config and the skill pack, check status, remove cleanly, and query the catalog.

MCP tools

Search and fetch catalog records with read-only JSON-RPC tool calls.

JSON + OpenAPI

Stable HTTP endpoints for agents that prefer direct API reads.

Recommended CLI setup

Use this first. It replaces the old npx skills path by installing both MCP and bundled skills where the agent supports them.

copy
npx canagentsuse@latest --help
npx canagentsuse@latest setup --all-agents --dry-run
npx canagentsuse@latest setup --all-agents --yes
npx canagentsuse@latest doctor

Fast path: npx canagentsuse@latest setup --all-agents --yes. Run the dry-run first if you want to preview every file write.

Install only the skill

Use this when you already have MCP configured or your agent only supports persistent instructions.

copy
npx canagentsuse@latest skills install can-agents-use --all-agents --yes

# skills.sh fallback
npx skills add phuctm97/canagentsuse --skill can-agents-use

# Manual fallback
mkdir -p ~/.codex/skills/can-agents-use
curl -fsSL https://www.canagentsuse.com/skill.md -o ~/.codex/skills/can-agents-use/SKILL.md

The CLI is preferred. skills.sh remains available with npx skills add phuctm97/canagentsuse --skill can-agents-use for agents that already standardize on it.

Choose install mode

Use the default setup for MCP plus skills, or choose a narrower mode for constrained agents.

copy
npx canagentsuse@latest setup --all-agents --yes
npx canagentsuse@latest setup --mcp --all-agents --yes
npx canagentsuse@latest setup --cli --all-agents --yes
npx canagentsuse@latest doctor

Agent-specific commands

Use one target when you do not want the CLI to touch every supported agent folder.

copy
npx canagentsuse@latest setup --claude --yes
npx canagentsuse@latest setup --cursor --yes
npx canagentsuse@latest setup --codex --yes
npx canagentsuse@latest setup --opencode --yes
npx canagentsuse@latest setup --gemini --yes
npx canagentsuse@latest setup --universal --yes

MCP smoke test

This confirms that production tool discovery is reachable. Local install checks pass after setup writes the selected agent configs.

copy
curl -fsS -X POST https://www.canagentsuse.com/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

1. Discover

Call search_agent_tools or /api/agent/search with page 1 and limit 10 for a query like billing, scraping, stripe, MCP, or browser.

2. Inspect

Fetch /api/agent/tools/{slug} to read evidence, support level, pricing, auth, and caution fields.

3. Verify

Follow evidence URLs to official docs before live money, production data, or account changes.

Safe access

Agents should use MCP, JSON, OpenAPI, or Markdown surfaces. The database is private persistence, not an agent integration contract.

Bulk reads

Use MCP get_agent_catalog, canagentsuse://catalog, /api/agent/catalog, or /llms-full.txt once per session when comparing many tools.

Request limits

Search returns 10 tools per page by default and maxes at 50. Request the next page only when hasMore is true.