PinMeTo Location MCP

The PinMeTo MCP Server enables seamless integration between the PinMeTo platform and AI agents such as Claude LLM, allowing users to interact with their location data and business insights through natural language. This server exposes a suite of tools that let you retrieve, analyze, and summarize data from PinMeTo, through multiple sources—including Google, Facebook, and Apple—covering metrics such as impressions, clicks, ratings, and more.

---

Installation

The MCP Server can be built from this repository, or a single-click installer is available for Claude Desktop.

---

Claude Desktop: One-Click Installation

The single-click installer binary for Claude Desktop is available in the "Releases" tab:

https://github.com/PinMeTo/pinmeto-location-mcp/releases

Below are instructions on how to generate the binary with npx:

Prerequisites (Claude Desktop: One-Click Installation)

• npm
• npx (included with npm)
• Claude Desktop

Steps (Claude Desktop: One-Click Installation)

1. Clone the repository:

   git clone https://github.com/PinMeTo/pinmeto-location-mcp.git

2. Open your project folder in your text editor.

   cd pinmeto-location-mcp

3. Build and Run the MCPB installer:

   npm install
   npm run build
   npx @anthropic-ai/mcpb pack

   • This generates a .mcpb file in your project directory.

4. Install in Claude Desktop:

   • With Claude Desktop open, double-click the .mcpb file.
   • Enter your PinMeTo API credentials when prompted (PinMeTo Account Settings).

• Enable the connector in Claude. You can now use the PinMeTo MCP integration.

---

Claude Desktop: Manual Installation

Below are instructions on how to manually integrate the PinMeTo MCP with Claude Desktop:

Prerequisites (Claude Desktop: Manual Installation)

• Node.js v22+ (recommended: NVM)
• npm (included with Node.js)
• Claude Desktop

Steps (Claude Desktop: Manual Installation)

1. Clone the repository:

   git clone https://github.com/PinMeTo/pinmeto-location-mcp.git

2. Open your project folder in your text editor.

   cd pinmeto-location-mcp

3. Install dependencies and build the project:

   npm install
   npm run build

4. Configure Claude Desktop:

   • Open your claude_desktop_config.json file. You can go to Preferences → Developer → Edit Config in the Claude Desktop Client. Or use on Mac:

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

   • Add the following MCP server configuration (with node)

     {
     "mcpServers": {
         "PinMeTo": {
         "command": "/absolute/path/to/node",
         "args": ["/absolute/path/to/project/build/index.js"],
         "env": {
             "PINMETO_API_URL": "",
             "PINMETO_ACCOUNT_ID": "",
             "PINMETO_APP_ID": "",
             "PINMETO_APP_SECRET": ""
         }
         }
     }
     }

   • Add the following MCP server configuration (with npx)

     {
     "mcpServers": {
         "PinMeTo": {
             "command": "npx",
             "args": ["-y", "PinMeTo/pinmeto-location-mcp"],
             "env": {
                 "PINMETO_ACCOUNT_ID": "",
                 "PINMETO_APP_ID": "",
                 "PINMETO_APP_SECRET": ""
             }
         }
     }
     
     }
     

   • Use absolute paths for both Node and your project:

   • Node path: which node

   • Project path: pwd

5. Get your PinMeTo API credentials:

   • Visit PinMeTo Account Settings and fill in the environment variables above.

6. Restart Claude Desktop:

   • Ensure all permissions are granted. You should now see "PinMeTo MCP" in your MCP selection.

Available Tools

• Get Location - Get pinmeto data on single location.
• Get Locations - Get all location data for site.
• All Google Insights - Get all Google insights for site locations.
• Google Location Insights - Get Google location insights for specific location.
• Google Location Ratings - Get Google location ratings for specific location.
• All Google Keywords - Get all Google keywords for your locations.
• Google Location Keywords - Get Google location keywords for a specific location.
• All Facebook Insights - Get all Facebook location insights for specific location.
• Facebook Location Insights - Get Facebook location insights for specific location.
• Facebook Brandpage Insights - Get Facebook insights for specific brandpage.
• Facebook Location Ratings Get Facebook location ratings for specific location.
• All Apple Insights Get all Apple location insights for site locations.
• Apple Location Insights Get Apple location insights for specific location.