Quickstart

Connected in a minute.

Pick the agent you already work in and paste one address into it. Every client takes the same server; only where you paste it differs: some through their own interface, some through a file. There is no SDK, no account and nothing to install.

Every snippet below connects to the country server at /gr/mcp, which answers for every Greek registry agoramcp mounts. For a single registry, swap the address for /gr/mcp/diavgeia. Nothing else about the entry changes.

Claude Code

Claude Code official docs

One command, no file to edit. Add --scope project to commit the server to the repository instead of your machine.

Terminal

claude mcp add --transport http greece https://agoramcp-server.vercel.app/gr/mcp

Claude

Claude official docs

The web and desktop apps take a URL through Connectors, nothing to install and no file to edit.

https://agoramcp-server.vercel.app/gr/mcp

This one connects from its own cloud rather than from the machine you are reading this on, so the address has to be reachable over the public internet.

In the app

1.Open Customize > Connectors.
2.Click +, then Add custom connector.
3.Paste the server URL and click Add.

Codex

Codex official docs

One command, or the same entry written into the config file. A .codex/config.toml in a trusted project scopes it to that project.

Terminal

codex mcp add greece --url https://agoramcp-server.vercel.app/gr/mcp

~/.codex/config.toml

[mcp_servers.greece]
url = "https://agoramcp-server.vercel.app/gr/mcp"

Cursor

Cursor official docs

The marketplace installs listed servers in one click; anything else goes in the config file. Use .cursor/mcp.json in a project to scope it there.

~/.cursor/mcp.json

{
  "mcpServers": {
    "greece": {
      "url": "https://agoramcp-server.vercel.app/gr/mcp"
    }
  }
}

Windsurf

Windsurf official docs

Cascade keeps its servers in one file. Note the key: Windsurf calls it serverUrl, where everyone else says url.

In the app

1.Click the MCPs icon at the top right of the Cascade panel.
2.Open the raw configuration.
3.Add the entry below and save.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "greece": {
      "serverUrl": "https://agoramcp-server.vercel.app/gr/mcp"
    }
  }
}

VS Code

VS Code official docs

Copilot reads a workspace file, or a user-level one through the command palette. The top-level key here is servers, not mcpServers.

In the editor

1.Open the command palette and run MCP: Add Server.
2.Choose Workspace or Global.
3.Pick HTTP and paste the server URL.

.vscode/mcp.json

{
  "servers": {
    "greece": {
      "type": "http",
      "url": "https://agoramcp-server.vercel.app/gr/mcp"
    }
  }
}

Any MCP client

Any MCP client official docs

The address is the whole integration. A client none of the entries above cover still takes it: paste it wherever it asks for a Streamable HTTP server, with no command to run and no key to send.

Server URL

https://agoramcp-server.vercel.app/gr/mcp

Check the setup

The official inspector, from the terminal rather than the client. It lists the tools the server is offering, which is the same list the model will see once it connects.

npx @modelcontextprotocol/inspector --cli https://agoramcp-server.vercel.app/gr/mcp \
  --transport http --method tools/list