io.github.Natden444/pickanagency
Search 47,000+ marketing agencies and get AI-matched with fitted agencies, from Pick an Agency.
Open source Repository Open in the app JSON README (API)
About
Search 47,000+ marketing agencies and get AI-matched with fitted agencies, from Pick an Agency.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- natden444
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Stars
- 2
- Last push
- 2026-06-12T22:26:38Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:07
- Updated
- 2026-08-29 03:02:07
- Origin id
io.github.Natden444/pickanagency
README
# Pick an Agency — MCP Server
[**Pick an Agency**](https://www.pickanagency.com) is a free directory of **47,000+ marketing agencies** with real client reviews and a free AI matching tool. This [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server lets any AI agent — Claude, ChatGPT, Cursor, Gumloop, and more — search the directory and get matched with fitted agencies, directly in conversation.
> Find the right marketing agency, backed by real reviews → [pickanagency.com](https://www.pickanagency.com)
## Endpoint
Hosted, public, read-only. **No API key required.** Streamable HTTP:
```
https://www.pickanagency.com/api/mcp/mcp
```
## Tools
| Tool | What it does |
|------|--------------|
| `search_agencies` | Search/filter the directory by free-text query, service (SEO, paid ads, social…), country, city, industry, and minimum rating. |
| `match_agencies` | The **"Get Matched"** engine: give a brief (services, location, budget, industry) and get a ranked shortlist of fitted agencies. |
| `get_agency` | A single agency's full profile (description, rating, services, website, recent reviews) by slug. |
Every result links back to the agency's profile on [pickanagency.com](https://www.pickanagency.com/agencies).
## Connect it
### Claude Code
```bash
claude mcp add --transport http pick-an-agency https://www.pickanagency.com/api/mcp/mcp
```
### Cursor — `~/.cursor/mcp.json`
```json
{
"mcpServers": {
"pick-an-agency": {
"url": "https://www.pickanagency.com/api/mcp/mcp"
}
}
}
```
### Claude Desktop / Claude.ai
**Settings → Connectors → Add custom connector** → paste the endpoint URL above.
### Run locally (stdio)
Prefer a local server? This package is a thin stdio proxy to the hosted endpoint:
```bash
npx -y github:Natden444/pickanagency-mcp
```
Or in any MCP client config:
```json
{ "mcpServers": { "pick-an-agency": { "command": "npx", "args": ["-y", "github:Natden444/pickanagency-mcp"] } } }
```
## Example prompts
- *"Find the top SEO agencies in the US."*
- *"Match me with a social media marketing agency in Paris, budget around $5k/month."*
- *"Tell me about the agency at slug `agence-pickers-paris-paris`."*
The agent calls the tools and answers with real agencies and their [pickanagency.com](https://www.pickanagency.com) profile links.
## About
[Pick an Agency](https://www.pickanagency.com) helps companies find the right marketing agency, backed by real client reviews and free AI matching ("Get Matched" returns 5 fitted agencies in about 60 seconds). Built by Nathan Denier.
- Website: <https://www.pickanagency.com>
- Browse agencies: <https://www.pickanagency.com/agencies>
- Get Matched: <https://www.pickanagency.com/get-matched>
## License
MIT © Pick an Agency
## Troubleshooting
**Tools don't appear after adding the connector** — MCP servers connect at session start: open a new conversation (Claude.ai) or restart the session (`claude` again in Claude Code), then check the connectors/tools menu. In Claude Code, `/mcp` lists connected servers and their status.
**"Connection failed" or timeouts** — verify the endpoint URL is exactly `https://www.pickanagency.com/api/mcp/mcp` (the `/mcp` suffix matters). The server is public; no API key, OAuth, or headers are needed. Check status by visiting [pickanagency.com](https://www.pickanagency.com) — if the site is up, the MCP endpoint is up.
**Empty results** — broaden the filters: try a country instead of a small city, or drop `min_rating`. `match_agencies` requires at least one service in `services`.
**`get_agency` says "no agency found"** — slugs must be exact. Find the right slug with `search_agencies` first (it's the last path segment of the profile URL).
**Still stuck?** Email [hello@pickanagency.com](mailto:hello@pickanagency.com) or [open an issue](https://github.com/Natden444/pickanagency-mcp/issues).