CitedNearby

AI assistants

Connect your AI assistant to your local rankings

Works with Claude, ChatGPT, Cursor and any MCP client. Once connected, you can ask about your rankings, reviews and listings in plain words, or have your assistant start a scan. It is included in every plan, the free plan too.

Your server address

Server address

https://citednearby.com/mcp

Create a free account

300 free credits every month. No card needed.

Before you start

Three things, two minutes.

1 A CitedNearby account. The free plan is fine.
2 The server address above. It is the same for every tool.
3 You will sign in to your account and click Allow. The page lets you choose whether the assistant can start scans. Scans use credits, just like in the dashboard.

CitedNearby

Your assistant wants to use your CitedNearby account

It can read your businesses, scans, rankings, reviews, listings and campaigns.

Let it start scans and campaigns (uses your credits)

Allow Cancel

A drawn sample

Connect your tool

Pick the one you use.

Claude (claude.ai, Desktop and mobile)

Works in claude.ai, Claude Desktop and the Claude mobile apps.

1

On claude.ai or in Claude Desktop, open Customize (called Settings in some versions), then Connectors.
2

Click "Add custom connector".
3

Name it CitedNearby and paste the server address. Leave the advanced OAuth fields empty.

https://citednearby.com/mcp
4

Click Add, then click Connect next to it.
5

Sign in to your CitedNearby account and click Allow.
6

In a chat, click the + button, open Connectors and make sure CitedNearby is on.

Good to know

The free Claude plan allows one custom connector.
On Team and Enterprise plans an owner adds it first in Organization settings > Connectors (Add > Custom > Web). Then each member clicks Connect.
Connectors added here also work in the Claude mobile apps.

ChatGPT

Set up in ChatGPT on the web.

1

In ChatGPT on the web, open Settings > Apps (Apps & Connectors in some versions) > Advanced settings and turn on Developer mode.
2

Click Create app (or Create).
3

Name it CitedNearby, paste the server address as the MCP server URL and choose OAuth for authentication.

https://citednearby.com/mcp
4

Tick the box that says you trust this app, then click Create.
5

Sign in to your CitedNearby account and click Allow.
6

In a chat, click +, choose Developer mode and pick CitedNearby.

Good to know

OpenAI offers full MCP apps (including actions such as starting scans) on ChatGPT Business, Enterprise and Edu. There, a workspace admin first turns on developer mode in the workspace settings.
On Pro, custom MCP apps can only read. Ask questions there, and start scans from the dashboard.
OpenAI renames these menus often. If a name differs, look for Apps or Connectors in Settings.

Claude Code

Add the server from your terminal.

1

Run this in your terminal:

claude mcp add --transport http citednearby https://citednearby.com/mcp
2

Start Claude Code, type /mcp, pick citednearby and choose Authenticate.
3

Your browser opens. Sign in to your CitedNearby account and click Allow.

Good to know

Prefer an API key? Run this instead (use a key from Settings > API Keys):

claude mcp add --transport http citednearby https://citednearby.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Add the server in Cursor, or in its settings file.

1

Open Cursor Settings > MCP (Tools & MCP in newer versions) and add a new MCP server. Or edit ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) and add this:

{ "mcpServers": { "citednearby": { "url": "https://citednearby.com/mcp" } } }
2

Cursor shows that the server needs a login. Click it, sign in to your CitedNearby account and click Allow.
3

Use it in Agent mode.

VS Code (GitHub Copilot)

Add the server from the Command Palette, or in a settings file.

1

Open the Command Palette, run "MCP: Add Server", choose HTTP, paste the server address, name it citednearby and choose Global.

https://citednearby.com/mcp
2

Or create .vscode/mcp.json in your project with this. Note that VS Code uses "servers", not "mcpServers".

{ "servers": { "citednearby": { "type": "http", "url": "https://citednearby.com/mcp" } } }
3

VS Code asks to let the server sign in. Allow it, sign in to your CitedNearby account and click Allow.
4

Use it from Copilot Chat in Agent mode.

Windsurf

Windsurf uses an API key instead of signing in.

1

Create an API key in Settings > API Keys. Tick "Can start scans" if you want Windsurf to be able to start scans.
Open API Keys →
2

Edit ~/.codeium/windsurf/mcp_config.json and add this, with your key:

{ "mcpServers": { "citednearby": { "serverUrl": "https://citednearby.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }
3

Refresh the MCP servers in Windsurf, or restart it.

Gemini CLI

Add the server to the Gemini CLI settings file.

1

Add this to ~/.gemini/settings.json:

{ "mcpServers": { "citednearby": { "httpUrl": "https://citednearby.com/mcp" } } }
2

Start gemini and run this command:

/mcp auth citednearby
3

Sign in to your CitedNearby account and click Allow.

Any other MCP client

Any tool that supports MCP over the web can connect.

1

Use the server address, with the transport "Streamable HTTP".

https://citednearby.com/mcp
2

Sign in with OAuth. The client finds the sign-in details on its own. Or send the header Authorization: Bearer YOUR_API_KEY, with a key from Settings > API Keys.
Open API Keys →
3

If your client reads a JSON file with "mcpServers", this is the usual shape:

{ "mcpServers": { "citednearby": { "url": "https://citednearby.com/mcp" } } }
4

And with an API key:

{ "mcpServers": { "citednearby": { "url": "https://citednearby.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

A choice

API keys or signing in?

Signing in (OAuth) is simplest. It is the only option in claude.ai and ChatGPT.

API keys suit tools you set up with a file. You make one in Settings > API Keys. The "Can start scans" switch decides whether a key may start scans. Keys can expire, and you can revoke any of them at any time.

Things to ask

Ask it the way you would ask a person.

How did my rankings for "plumber near me" change this month?
Which competitors beat me in the north of town?
Summarise this week's new reviews and draft replies.
Run a 7×7 scan for "emergency plumber" and tell me the results.
Is my business mentioned by ChatGPT and Perplexity for "best dentist in Austin"?
What's wrong with my listings?

What it can do

What your assistant can do.

Read your businesses, keywords, scans (with the grid and competitors), campaigns, reviews and listings.
Start map, AI and Google Search scans, campaigns and rescans, when you allow it. They use credits exactly as in the dashboard.
It only sees your account.
You can disconnect it at any time in Settings > AI Assistants.

Troubleshooting

If something goes wrong

I cannot find "Add custom connector" in Claude: The free Claude plan allows one connector, so remove the one you have first. On Team and Enterprise plans, ask an owner to add it in Organization settings > Connectors, then click Connect yourself.
ChatGPT has no Developer mode: Actions such as starting scans need ChatGPT Business, Enterprise or Edu, and a workspace admin has to turn developer mode on first. On other plans, ask questions in ChatGPT and start scans from the dashboard.
The assistant says it can only read: You did not allow scans when you connected. In Settings > AI Assistants, disconnect it and connect again with the box ticked. Or make an API key with "Can start scans" turned on.
The sign-in window does not open: Use an API key instead. Create one in Settings > API Keys and send it as the header Authorization: Bearer YOUR_API_KEY.
It says I do not have enough credits: Scans started by your assistant use credits exactly as they do in the dashboard. Check your balance in the dashboard, then ask for a smaller scan or top up.

FAQ

Questions, answered plainly.

Is it free?

Connecting is included in every plan, the free plan too. Reading your data costs nothing. Scans your assistant starts use credits, exactly as they do in the dashboard.

Which AI tools can I use?

Claude, ChatGPT, Cursor, VS Code, Windsurf and Gemini CLI are covered above. Any other tool that supports MCP can connect too, with the same server address.

Is my data safe?

The assistant reads only your own account, and only through the tools we give it. You can disconnect it at any time in Settings > AI Assistants. We do not see your chats. We only see the requests your assistant sends to CitedNearby.

Can it start scans without asking me?

Only if you allowed it when you connected. Even then, every scan it starts shows in your credits history, so you can see what was spent.

What is MCP?

MCP is short for Model Context Protocol, an open standard that lets AI assistants use tools and read data from other services.

Try it with your own business.

300 free credits every month. No card needed.

Create a free account See the features