pinmeto-location

PinMeTo Location MCP connects your PinMeTo locations to AI assistants, enabling natural language queries to insights about your business. Through this MCP, you can ask questions that aggregate data across all locations, such as average Google ratings, most recent reviews, or performance comparisons over time. It exposes capabilities like Google Insights (views, searches, directions, calls, clicks), Google and Facebook Ratings/Insights, Apple Insights, and keyword performance, all accessible via supported MCP clients (Claude Desktop, VS Code, Cursor, etc.). Use it to generate actionable prompts and receive consolidated analytics from your locations in natural language. The example prompts section in the docs provides organized prompts tailored to different business needs, such as identifying underperforming locations or analyzing sentiment across reviews.

Prerequisites:

• Node.js and npm installed on your machine, or access to an MCP client that can run npx-based MCP servers.
• Optional: credentials for PinMeTo API (account ID, app ID, app secret).

Installation steps:

1. Ensure you have Node.js installed. You can verify with: node -v npm -v
2. Set up your PinMeTo credentials (one-time or per-session):
   • On macOS/Linux: export PINMETO_ACCOUNT_ID=your_account_id export PINMETO_APP_ID=your_app_id export PINMETO_APP_SECRET=your_app_secret
   • On Windows (PowerShell): $env:PINMETO_ACCOUNT_ID="your_account_id" $env:PINMETO_APP_ID="your_app_id" $env:PINMETO_APP_SECRET="your_app_secret"
3. Start the MCP server via npx: npx -y @pinmeto/pinmeto-location-mcp When prompted, you may be asked to provide credentials depending on the installation flow.

Alternative (manual usage of the MCP bundle):

• Download or use the MCP bundle and follow the prompts in Claude Desktop, Cursor, or VS Code integration to install and configure the server with your PinMeTo API credentials.

Tips and common notes:

• The MCP server requires PinMeTo API access; ensure your account has the necessary permissions.
• Credentials can be provided via environment variables or prompted during installation depending on your setup.
• Supported MCP clients include Claude Desktop, VS Code, and Cursor; early access users can refer to the installation badges in the README for options.
• For best results, ensure your PinMeTo locations are properly linked to your PinMeTo account in the PinMeTo Console before querying insights.
• If you encounter issues, consult the Troubleshooting section in docs/GETTING-STARTED.md and verify that the environment variables are correctly set.