# Connect over MCP

Updated November 12, 2026.

clickd’s MCP server is at `https://clickd.com/mcp`. Add that address to Claude, ChatGPT, Cursor or any agent that speaks MCP, and it works at once, with no key and no sign-up.

> **Opened it in a browser?.** `https://clickd.com/mcp` is an address for agents: they send it messages, and a browser opening it is shown this page. Add the address to your agent below.

## How do I add clickd to my agent?

Add the address where your agent keeps its MCP servers. Pick where yours runs: the setting is the address alone, and nothing else is needed to start.

### Claude Code

1. Run this once, from any folder. Claude Code keeps it for every project. (Terminal)

```
claude mcp add --transport http clickd https://clickd.com/mcp
```

2. Not needed to start. A free key, made with an email, lets your agent read a site again after a fix and adds the private parts of sites you claim. With one, the setting gains this line.

```
claude mcp add --transport http clickd https://clickd.com/mcp \
  --header "Authorization: Bearer mk_your_key"
```

### Codex

1. Add this to Codex’s settings, then start Codex again. (~/.codex/config.toml)

```
[mcp_servers.clickd]
url = "https://clickd.com/mcp"
```

2. Not needed to start. A free key, made with an email, lets your agent read a site again after a fix and adds the private parts of sites you claim. With one, the setting gains this line.

```
bearer_token_env_var = "CLICKD_KEY"
```

### Gemini CLI

1. Add this to Gemini CLI’s settings, then start it again and run /mcp to see clickd’s tools. (~/.gemini/settings.json)

```
{
  "mcpServers": {
    "clickd": {
      "httpUrl": "https://clickd.com/mcp"
    }
  }
}
```

2. Not needed to start. A free key, made with an email, lets your agent read a site again after a fix and adds the private parts of sites you claim. With one, the setting gains this line.

```
"headers": { "Authorization": "Bearer mk_your_key" }
```

### Cursor

1. Add this in the site’s repository, then turn clickd on under MCP in Cursor’s settings. (.cursor/mcp.json)

```
{
  "mcpServers": {
    "clickd": {
      "url": "https://clickd.com/mcp"
    }
  }
}
```

2. Not needed to start. A free key, made with an email, lets your agent read a site again after a fix and adds the private parts of sites you claim. With one, the setting gains this line.

```
"headers": { "Authorization": "Bearer ${env:CLICKD_KEY}" }
```

### Antigravity

1. Add this under Settings, Customizations, MCP servers, or in this file; then refresh the list of servers. In one project only, use .agents/mcp_config.json instead. (~/.gemini/config/mcp_config.json)

```
{
  "mcpServers": {
    "clickd": {
      "serverUrl": "https://clickd.com/mcp"
    }
  }
}
```

2. Not needed to start. A free key, made with an email, lets your agent read a site again after a fix and adds the private parts of sites you claim. With one, the setting gains this line.

```
"headers": { "Authorization": "Bearer mk_your_key" }
```

### VS Code

1. Add this in the site’s repository, then start the server from the file. (.vscode/mcp.json)

```
{
  "servers": {
    "clickd": {
      "type": "http",
      "url": "https://clickd.com/mcp"
    }
  }
}
```

2. Not needed to start. A free key, made with an email, lets your agent read a site again after a fix and adds the private parts of sites you claim. With one, the setting gains this line.

```
"headers": { "Authorization": "Bearer ${input:clickd-key}" }
```

### Windsurf

1. Add this to Windsurf’s MCP settings, in ~/.codeium/windsurf/mcp_config.json, then refresh its list of servers. (mcp_config.json)

```
{
  "mcpServers": {
    "clickd": {
      "serverUrl": "https://clickd.com/mcp"
    }
  }
}
```

2. Not needed to start. A free key, made with an email, lets your agent read a site again after a fix and adds the private parts of sites you claim. With one, the setting gains this line.

```
"headers": { "Authorization": "Bearer mk_your_key" }
```

### Any agent

1. Any client that speaks MCP over HTTP connects with these two things. No key and no sign‑in. (Settings)

```
Address    https://clickd.com/mcp
Transport  Streamable HTTP
```

2. Not needed to start. A free key, made with an email, lets your agent read a site again after a fix and adds the private parts of sites you claim. With one, the setting gains this line.

```
Authorization: Bearer mk_your_key
```

## What works with no key?

Most of it. Without a key an agent makes up to 60 calls an hour from one address. A free key, made with an email, adds the rest, and your agent can sign you up itself, with `clickd_signup`. Without an email it gets a throwaway key instead: clickd knows the agent by it, and it asks for a few reads an hour, but it cannot claim a site.

| What your agent can do | No key | Free key |
| --- | --- | --- |
| Read any site’s public report, fix list and plan | Yes | Yes |
| Read the rulebook and the leaderboard, and run the free checks | Yes | Yes |
| Ask clickd to read a site again after a fix | No | Yes |
| See the private parts of a site you claim | No | Yes |

## What if my assistant has no MCP?

It opens one address. An assistant that can only open web pages, such as Google’s AI Mode or ChatGPT search, scans a site by opening one address. It answers in plain text with the score, the grade and the fixes worth the most. A site not read yet is put in line, and the same address answers with its report a few minutes later.

```
https://clickd.com/scan/example.com
```

## Which tools does it list?

`/mcp` lists the 17 tools most work needs, and `/mcp/all` lists every tool. Every tool’s name answers at either. What each one does is in [the tools reference](https://clickd.com/docs/tools).

## Next

- [Quickstart](https://clickd.com/docs/quickstart.md)
- [Fix what fails first](https://clickd.com/docs/fix.md)

## Sources

- [Model Context Protocol specification](https://modelcontextprotocol.io/specification/2025-06-18), Model Context Protocol: How an agent connects to clickd and calls its tools.