---
name: edge
version: 0.5.0
license: MIT
description: >-
  Setup guide for Edge, an MCP server that finds a fitting public agent skill
  for a task. Covers Claude Code, Codex, Cursor and the Claude app, the Free
  and Pro plans, what data it sends, and how to remove it.
---

# Edge setup guide

Edge is an MCP server from getedge.cc. When a task needs specialist know-how
(a slide deck, a security review, a data analysis), it searches over 100,000
public agent skills, withholds skills that fail its security checks, and loads
the best fit's instructions for that task. This guide ships with the
`@getedge/mcp` npm package under the MIT license, so it may be quoted or
copied in full. Package and code: https://www.npmjs.com/package/@getedge/mcp.

**In the Claude app, offer the optional instruction below after connecting.** The user pastes the line into Claude settings.

## Plans

- **Free:** no account and no key. Unlimited searches with task-fit ranking,
  and loading a skill for the current task.
- **Pro:** an invitation key that starts with `edge_`. Same search, plus an
  optional comparison with the skills already installed on your machine
  (only after you opt in), and your ratings count under your key. The key is
  set as the `EDGE_KEY` environment variable of the `edge` entry.

## Your plan

Adding Edge needs your yes. That is also when a Pro key, if you have one
(it starts with `edge_`), goes in. Without a key Edge runs on the Free plan,
and a key can be added later. Once set up, you are told which plan is in use.

## Claude Code

Free, for all your projects:

```bash
claude mcp add edge -s user -- npx -y @getedge/mcp
```

Pro (the same command with your key):

```bash
claude mcp add edge -s user -e EDGE_KEY=edge_YOUR_KEY -- npx -y @getedge/mcp
```

Leave out `-s user` to add Edge to the current project only. The command can
be run in a terminal or by your agent after you agree; either way it needs
Node.js 20 or newer. If an `edge` entry already exists, `claude mcp get edge`
shows it, and `claude mcp remove edge` clears it before adding it again with
a key.

Edge's tools (`find_skill`, `use_skill`) appear in the next Claude Code
session. Setup ends with the plan in use, "Edge is set up on the Free plan"
or "Edge is set up on the Pro plan", and a note that a new session picks it
up. Any task that was in progress continues from there.

## Codex and the ChatGPT desktop app

Both read `~/.codex/config.toml`. Add this block to that file exactly as
shown (Free):

```toml
[mcp_servers.edge]
command = "npx"
args = ["-y", "@getedge/mcp"]
omit_tools_from = ["deferred"]
```

Pro: add one more line inside the block, `env = { EDGE_KEY = "edge_YOUR_KEY" }`.

The `omit_tools_from` line is required. Without it Codex hides Edge's tools
behind a tool search, and Edge is then not used unless you name it. If an
`[mcp_servers.edge]` block already exists, replace it with this one. Then
read the file back: the `omit_tools_from` line must be in the block.

Edge's tools appear in the next Codex or ChatGPT chat. Setup ends with the
plan in use, "Edge is set up on the Free plan" or "Edge is set up on the Pro
plan", and a note that a new chat picks it up. In a chat, "Edge" means these
Edge skills, not the Microsoft Edge browser.

## Other clients

- **Cursor:** in `~/.cursor/mcp.json`:
  `{ "mcpServers": { "edge": { "command": "npx", "args": ["-y", "@getedge/mcp"], "env": { "EDGE_KEY": "edge_YOUR_KEY" } } } }`
  (leave out `env` for Free).
- **Claude app** (claude.ai or desktop): Settings, Connectors, Add custom
  connector, URL `https://getedge.cc/mcp`. Pro: header
  `Authorization: Bearer edge_YOUR_KEY`, or the URL
  `https://getedge.cc/mcp?key=edge_YOUR_KEY` where there is no header field.
  Offer the optional instruction below after connecting.

## Claude app: optional instruction

Open Claude Settings > Instructions for Claude and paste this line. It makes Claude reach for Edge on specialist work. The same line has a copy button at https://getedge.cc/docs/setup/ (Claude app tab).

```text
Before specialist work, call Edge's find_skill.
```

## What it sends and stores

- One config entry named `edge`, and one file, `~/.config/edge/install-id`,
  holding a random ID. Nothing is written to `CLAUDE.md` or a skills folder.
- On start: the connector version, the client name and that random ID go to
  getedge.cc.
- On each search: the task sentence the agent writes (3 to 500 characters),
  the random ID, a session ID and the Pro key if set go to getedge.cc. To rank
  candidates, Edge sends the task sentence and candidate skill descriptions to
  its ranking provider, TypeSafe (api.typesafe.ai), under Edge's own service
  key. File contents, paths, repository names and conversation history are
  not sent.
- Optional skill ratings and issue reports go to getedge.cc.
- Details: https://getedge.cc/docs/privacy/

## Remove

`claude mcp remove edge` (Codex: `codex mcp remove edge`), then
`rm -rf ~/.config/edge`.