Pickanagency MCP

What Natden444/pickanagency-mcp MCP server does

Natden444/pickanagency-mcp MCP server gives an AI client read-only access to Pick an Agency, a directory containing more than 47,000 marketing agencies. It supports three directory tasks: filtering agencies, generating an AI-based shortlist, and reading an individual agency profile.

The search_agencies tool accepts a free-text query and filters for service, country, city, industry, and minimum rating. The match_agencies tool uses a brief describing services, location, budget, and industry to return fitted agencies in ranked order. At least one service is required for matching. The get_agency tool retrieves a profile using its exact slug and can return the description, rating, services, website, and recent reviews.

Results link back to the corresponding agency profiles on pickanagency.com, allowing an agent or developer to provide source pages with its results.

How it works

The primary deployment is a hosted Streamable HTTP endpoint:

https://www.pickanagency.com/api/mcp/mcp

Natden444/pickanagency-mcp MCP server is public and read-only. It does not require an API key, OAuth flow, or request headers. An MCP-compatible client connects to the endpoint, discovers the three tools, and sends tool calls during a conversation. The underlying directory and matching functionality are provided by Pick an Agency.

The repository also provides a local stdio option. That option is a thin proxy which forwards MCP traffic to the hosted endpoint rather than running a separate local agency database or matching engine.

Setup and configuration

For a hosted connection, add the endpoint URL to an MCP client. Cursor can use a server entry with a url property, while Claude Desktop or Claude.ai can add it as a custom connector. Claude Code can register it with an HTTP transport, for example:

claude mcp add --transport http pick-an-agency https://www.pickanagency.com/api/mcp/mcp

To use the repository's stdio proxy, run:

npx -y github:Natden444/pickanagency-mcp

No environment variables or credentials are documented as required. After changing a connection, start a new conversation or restart the client session so the tools are discovered.

Tools and capabilities

• Search the agency directory with text and structured filters.
• Filter by marketing service, including examples such as SEO, paid advertising, and social media.
• Match a brief containing services, location, budget, and industry to a ranked shortlist.
• Retrieve a full agency profile by exact slug.
• Return profile links, ratings, services, websites, descriptions, and recent reviews where available.

Limitations and notes

Natden444/pickanagency-mcp MCP server only exposes read operations; the provided material does not describe agency creation, editing, or other write actions. Matching requires at least one service. If a search returns too few results, broadening the country or removing the minimum-rating filter may help.

Agency slugs must match exactly. A practical workflow is to call search_agencies first and use the final path segment from the resulting profile URL with get_agency.

The endpoint URL must include the final /mcp suffix. If tools do not appear, reconnect the client by opening a new conversation or restarting the session. Availability depends on the Pick an Agency site and hosted endpoint being reachable.