# convention.sh

> A hosted Model Context Protocol (MCP) server that ships hand-tuned TypeScript
> coding conventions to AI coding agents on demand. Agents fetch one snippet at
> a time — exactly when they're about to write that code — so you pay for the
> tokens you actually use, not the ones you might.

The MCP server itself does no inference, runs no LLM, and never receives or
trains on user source code. It is a static-content delivery server.

- Endpoint: `https://mcp.convention.sh`
- Transport: streamable HTTP
- Server name: `conventiondotsh`
- Authentication (paid plans): `Authorization: Bearer <token>`

---

## How to add convention.sh as an MCP server

### Claude Code

```bash
claude mcp add conventiondotsh --transport http https://mcp.convention.sh
```

With an API token (paid plans):

```bash
claude mcp add conventiondotsh --transport http https://mcp.convention.sh --header "Authorization: Bearer <your-token>"
```

Verify with `claude mcp list`.

### Cursor

One-click install (preferred):

```
cursor://anysphere.cursor-deeplink/mcp/install?name=conventiondotsh&config=eyJ1cmwiOiJodHRwczovL21jcC5jb252ZW50aW9uLnNoIn0=
```

Or, add this entry to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "conventiondotsh": {
      "url": "https://mcp.convention.sh"
    }
  }
}
```

With an API token, add a `headers` field:

```json
{
  "mcpServers": {
    "conventiondotsh": {
      "url": "https://mcp.convention.sh",
      "headers": { "Authorization": "Bearer <your-token>" }
    }
  }
}
```

### Codex

Add this section to `~/.codex/config.toml`:

```toml
[mcp_servers.conventiondotsh]
url = "https://mcp.convention.sh"
transport = "http"
```

With an API token, add a `headers` line:

```toml
[mcp_servers.conventiondotsh]
url = "https://mcp.convention.sh"
transport = "http"
headers = { Authorization = "Bearer <your-token>" }
```

### Amp

Add this entry to `~/.amp/amp.json`:

```json
{
  "mcpServers": {
    "conventiondotsh": {
      "url": "https://mcp.convention.sh"
    }
  }
}
```

With an API token, add a `headers` field as in the Cursor example above.

---

## Plans

- **Free** — personal, non-commercial use. Subject to a weekly read budget.
- **Pro** — $99/yr, commercial use, one developer.
- **Team** — $299/yr, commercial use, unlimited developers within a single
  organization.

Plan licensing is described at https://convention.sh/terms.

---

## Privacy

- We do **not** collect, store, or train on user source code.
- The MCP server performs **no AI inference** on its request path — it is a
  static markdown delivery server.

Full policy: https://convention.sh/privacy

---

## Reference

- Docs: https://convention.sh/docs
- Pricing: https://convention.sh/#pricing
- GitHub: https://github.com/ryanhaticus/convention.sh
- MCP specification: https://modelcontextprotocol.io