Navigate

// install_cursor

Using AgentRoot with Cursor

Search the AgentRoot registry and install MCP servers and skills directly into Cursor. Skills integrate with Cursor's rules system, and MCP servers are added to your Cursor MCP configuration.

// what_you_need

Cursor IDE installed
Node.js 18+ (for npx commands)
A project open in Cursor (for project-scoped installs)

1Search the registry

# Search for MCP servers
$ npx agent-root search "database" --type mcp

dbtools.io/postgres-mcp        mcp  Postgres MCP Server
  transport: sse | tools: query, describe-table, list-tables

# Search for skills
$ npx agent-root search "typescript" --type skill

tsguide.dev/ts-patterns        skill  TypeScript Patterns
  skills: type-narrowing, generics-guide, error-handling

2Install a record

Use the --tool cursor flag to install into Cursor:

Installing an MCP server:

$ npx -p @agent-root/cli agent-root install dbtools.io/postgres-mcp --tool cursor --project

# The CLI prints the JSON snippet to paste into .cursor/mcp.json:
{
  "mcpServers": {
    "postgres-mcp": {
      "command": "npx",
      "args": ["@dbtools/postgres-mcp", "--connection", "$POSTGRES_URL"]
    }
  }
}

Install never mutates Cursor's config automatically. Paste the snippet into .cursor/mcp.json at your project root, then restart Cursor.

Installing skills:

$ npx -p @agent-root/cli agent-root install tsguide.dev/ts-patterns --tool cursor --project

# Writes skill files into Cursor's skills dir:
# .cursor/skills/tsguide.dev/ts-patterns/SKILL.md
# (plus any referenced supporting files)

Cursor only supports project-scoped installs. --tool cursor always writes inside the current project directory (.cursor/skills/); there is no ~/.cursor/skills/ home-level location.

3Verify it works

For MCP servers, restart Cursor and check the MCP panel in settings:

# Open Cursor Settings > MCP
# You should see postgres-mcp listed with a green status indicator

For skills, ask Cursor about the topic and it will reference the skill content in its responses.

4Project-scoped only

Cursor does not have a global skills directory. Every --tool cursor install is project-scoped, lands in .cursor/skills/<domain>/<record-id>/, and can be committed to version control so the whole team picks it up:

# Cursor installs always go into the project
$ npx -p @agent-root/cli agent-root install tsguide.dev/ts-patterns --tool cursor --project
# Installs to: .cursor/skills/tsguide.dev/ts-patterns/

// troubleshooting

MCP server not connecting: The CLI prints the config but does not write to .cursor/mcp.json. Paste the snippet in yourself, then restart Cursor. Verify the server command also runs independently from a terminal.
Skills not loading: Verify files exist at .cursor/skills/<domain>/<record-id>/SKILL.md. AgentRoot does not write to .cursorrules; Cursor picks up .cursor/skills/ on its own.
Transport errors: SSE servers require network access. For local-only use, look for servers with stdio transport.
Outdated records: Run agent-root update <domain>/<record-id> to re-fetch from the publisher.

// next_steps

Install with Claude Code Install with Codex CLI Publish your own skills