Developer Documentation

PlaceGraph is a specialized directory exposed directly as a Model Context Protocol (MCP) server. MCP allows AI tools—including Claude Desktop, Cursor, or your custom agent fleets—to query our structured, geospatially indexed local business profiles in real-time.

Connecting Your Client

Our MCP registry is distributed publicly. You can trigger the server locally using the `npx` script package, supplying your verification API key inside the environment schema config.

Shell command

npx -y @placegraph/mcp-server

Claude Desktop Configuration

To connect PlaceGraph directly to your Claude Desktop application, add the server details block inside your local configuration file.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "placegraph": {
      "command": "npx",
      "args": [
        "-y",
        "@placegraph/mcp-server"
      ],
      "env": {
        "PLACEGRAPH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

MCP Tools Reference

Below are the public JSON-RPC tools currently implemented by the PlaceGraph protocol server. Select a tool to view its parameters and sample responses.

search_businesses

Fuzzy-search listings by name, description, category, or general business terms.

// PARAMETERS

Name	Type	Required	Description
query	string	Yes	Fuzzy search term (e.g. "seafood restaurant", "rooftop watch store").
city	string	No	Limit search results to a specific city (e.g. "Naples").
limit	number	No	Number of results to retrieve (default: 5, max: 20).

// SAMPLE RESPONSE

[
  {
    "id": "e0bfa549-cf91-49b2-8be3-4e73b22acf91",
    "name": "CrestEdge Bistro",
    "short_description": "Coastal-infused dining with a premium local seafood menu.",
    "city": "Naples",
    "state": "FL",
    "primary_category": "Dining & Restaurant",
    "subscription_tier": "premium"
  }
]