Agents

Give your agent the skill

For ongoing use, install the plugin or use the CLI below.

Use a plugin

The repository plugin bundles the skill and MCP connection for Codex, Claude Code, and Cursor. Follow your client's plugin installation instructions, then sign in through its MCP controls.

If you use the plugin, skip the CLI setup below. If you already configured MCP directly, disable one of the two connections in your client.

Set up with the CLI

Install the CLI with Node.js 22.22.0 or later:

npm install --global @edgestore/cli@rc

Then run this in your application directory:

edgestore agent setup --client codex

Use claude for Claude Code or cursor for Cursor. This installs the setup skill and configures MCP for the project. Add --skills-only to skip MCP, or --global to install for all projects. Restart your client or open a new task to load the skill. Setup does not sign you in.

The skill reads API references bundled with your installed EdgeStore packages. After upgrading the CLI, update the skill with edgestore agent update --client codex. This leaves your application packages unchanged.

MCP only

edgestore mcp setup --client codex

This configures account and project tools without installing the skill.

Configure manually

Add EdgeStore to your client's project configuration. Merge the entry into an existing config rather than replacing other servers.

[mcp_servers.edgestore]
url = "https://api.edgestore.dev/mcp"

{
  "mcpServers": {
    "edgestore": {
      "type": "http",
      "url": "https://api.edgestore.dev/mcp"
    }
  }
}

{
  "mcpServers": {
    "edgestore": {
      "url": "https://api.edgestore.dev/mcp"
    }
  }
}

Sign in

Restart your client after saving the config, then connect EdgeStore:

• Codex requires project trust for .codex/config.toml. Run codex mcp login edgestore, then use /mcp to check the connection.
• In Claude Code, approve the project's MCP configuration, then use /mcp to select EdgeStore and sign in.
• In Cursor, open MCP settings and connect the EdgeStore server.

MCP sign-in is separate from edgestore login.

After signing in, ask your agent to list your EdgeStore projects to check tool access.

Client instructions: Codex, Claude Code, and Cursor.

Give your agent the docs

Start with Quick start or the adapter for Next.js App or Pages Router, TanStack Start, Remix / React Router, Astro, Hono, Express, or Fastify. React-only applications need a backend for the server adapter.

• llms.txt lists the docs.
• llms-full.txt includes all pages in one Markdown response.
• Add .md to a page URL, such as quick-start.md, or use its Copy Markdown button.

Run edgestore agent context --json to find installed versions and their local agent-docs/ references.