Synup MCP v1.0.0

Synup MCP — Getting Started

Connect your AI agent directly to Synup using the Model Context Protocol (MCP). Manage locations, reviews, social media, rankings, and campaigns through natural language commands in Claude Desktop, Cursor, or Windsurf.

💡 What is MCP?
The Model Context Protocol allows AI agents to securely interact with external systems. With Synup MCP, your AI can query data, create locations, respond to reviews, publish social posts, and more.

What you can do

  • >
    Locations — Create locations, search by name/city/tags, update address/hours/phone, check listing sync status
  • >
    Reviews — Respond to reviews at scale, launch email/SMS campaigns, track response rates and ratings
  • >
    Social Media — Publish posts to Google and Facebook, schedule recurring campaigns, manage content
  • >
    Rankings — Track keyword positions on Google Search and Maps, generate geographic heatmaps, monitor trends
  • >
    Insights — Pull profile views, website clicks, phone calls, direction requests, engagement metrics
  • >
    Team — Invite team members, update permissions, manage user access

Quick Start

  • > Get an API key from Synup Integrations
  • > Configure MCP in your IDE (Claude, Cursor, or Windsurf)
  • > Test the connection with a simple command
  • > Build your workflow — automate reviews, publish posts, and manage locations

Getting Your API Key

You'll need an API key from Synup to authenticate with the MCP. Follow these steps:

Step 1: Log in to your account and get your API key

Log in to your Synup account, then navigate to Account Settings → Integrations → API Keys.

Step 2: Create or copy your API Key

If you don't have an API key yet, click "Generate New Key". Copy the key to a secure location.

Managed Endpoint

All Synup MCP operations go through a managed endpoint with automatic authentication.

Endpoint URL
https://mcp-agent.synup.com/mcp

Required Headers

Every request must include these authentication headers:

Header Value Description
X-api-key string Your Synup API key from Integrations → API Keys. Treat this like a password.
X-access-mode write|read write enables all tools (create, update, delete). read enables query-only tools.

Synup MCP exposes the following tools:

Complete reference of all available operations (127 total):

Page of 13
Tool Name Friendly Name Description
Page of 13

MCP Client Availability

Install Synup MCP in your preferred AI editor. Each supports a one-click installation or manual config.

Run this command in your terminal:

bash 
claude mcp add --transport http synup-mcp https://mcp-agent.synup.com/mcp \
  --header "X-api-key: YOUR_API_KEY" \
  --header "X-access-mode: write"

After Installing

Open Claude Code and run /mcp to activate the MCP server.

Replace YOUR_API_KEY_HERE with your API key from Settings → Integrations.

What's Next?

With the MCP configured, your AI agent can:

  1. Query data in natural language — "How many 3-star reviews did we get this week?" or "Show me all locations in Texas"
  2. Execute operations — "Respond to pending reviews with our standard message" or "Publish a post to Google for my downtown location"
  3. Automate workflows — "Check rankings every Friday and email me a summary" or "Schedule posts for the next 2 weeks"
  4. Run reports — "What's our average rating across all locations?" or "Which keywords drive the most traffic?"

The MCP provides access to the full Synup platform — see the tools table for all available operations and their descriptions.

Security Notes

🔒 Keep Your Account Safe
  • >Never commit API keys to git or share in public repositories
  • >Use environment variables or secure config management in production
  • >Use read mode when you are testing out the mcp
  • >Rotate keys periodically in Synup Integrations → API Keys
  • >Monitor MCP activity logs for unauthorized access attempts
  • >Keep your Synup password strong and unique