Synup MCP

Introduction

Synup MCP provides a unified Model Context Protocol (MCP) interface to manage locations, reviews, social media, rankings, and campaigns through AI agents.

What is MCP?

MCP (Model Context Protocol) is an open standard that enables AI assistants to connect directly to external data sources and tools through a secure, standardized interface. Synup MCP gives you secure, authenticated access to your Synup data through natural language, enabling AI assistants (such as Claude Code, Cursor, Windsurf) to retrieve location details, analyze ranking performance, review citation status, and generate insights directly from your account. The connection is HTTP streamable and authenticated via headers.

Core Details

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

Protocol: Model Context Protocol (MCP) - HTTP Streamable

Authentication: API Key + Access Mode Headers

Tools Available: 120+ total

Supported Assistants: Claude Code, Cursor, Windsurf

Getting Started

Before You Begin

Ensure you have:

✅ An active Synup account

✅ An API key (from Settings → Integrations)

✅ One of these installed: Claude Code, Cursor, or Windsurf

Claude Code

Run this command in your terminal:

After this open Claude Code and run /mcp to activate the MCP server.

Replace YOUR_API_KEY_HERE with your API key from Settings → Integrations.

Cursor

One-click install: Add Synup MCP to Cursor

Manual config — Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "synup": {
      "url": "https://mcp-agent.synup.com/mcp",
      "type": "http",
      "headers": {
        "X-api-key": "YOUR_API_KEY_HERE",
        "X-access-mode": "write"
      }
    }
  }
}

Windsurf

Manual config:

macOS/Linux: ~/.codeium/windsurf/mcp_config.json

Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

{
  "mcpServers": {
    "synup": {
      "url": "https://mcp-agent.synup.com/mcp",
      "type": "stdio",
      "disabled": false,
      "headers": {
        "X-api-key": "YOUR_API_KEY_HERE",
        "X-access-mode": "write"
      }
    }
  }
}

Activate & Test
Replace YOUR_API_KEY_HERE with your API key from Settings → Integrations, then restart your AI editor. You're ready to start using Synup MCP!

Authentication

How to Authenticate

Every request must include two required headers:

Header	Type	Description
`X-api-key`	string	API key from Settings → Integrations
`X-access-mode`	enum	`write` (full access) or `read` (query-only)

Getting Your API Key

Navigate to Settings → Integrations

Create a new API Key or copy your existing key

Keep it secure (treat like a password)

Access Modes

write — Full read/write access (create, update, delete operations)

read — Query-only access (recommended for testing)

What Can You Do?

Synup MCP enables you to leverage your Synup data through conversational AI. Here's what you can accomplish:

Location Management — Query, filter, and manage your business locations

Review Management — Pull reviews from all platforms, respond at scale, track sentiment

Keyword Tracking — Monitor rankings across Google Search and Maps

Geographic Visibility — Analyze grid-based local search presence

Citations — Check publisher listings, identify inconsistencies, index/ citations

Review Campaigns — Create and launch email/SMS campaigns to collect reviews

Social Media — Post to Google Business Profile and Facebook, schedule content

Competitive Intelligence — Compare rankings, reviews, and engagement vs. competitors

Portfolio Insights — Compare performance across all locations, identify priorities

Reporting — Generate performance summaries and actionable reports

Example Prompts

Use these prompts to quickly get started with the Synup MCP. Copy and paste into Claude Code, Cursor, or Windsurf.

Review Monitoring & Response
Agent monitors reviews across Google, Facebook, Yelp. It drafts on-brand replies, flags critical reviews in Slack, and tracks sentiment trends over time.

Grid Rank Action Plan
Agent scans heat-maps across all locations, identifies underperforming geographic zones, auto-adds target keywords to tracking, and schedules social posts in weak zones to boost visibility.

Social Media Automation
Agent pulls event info from your calendar, drafts location-specific copy, routes to Slack for approval, then publishes across channels on schedule.

Review Campaign Triggers
Agent reads transaction data from CRM or Google Sheets, segments customers by purchase type, launches targeted campaigns, tracks conversion, and reports results in Notion.

Competitive Intelligence
Agent tracks competitor rankings, review velocity, and posting frequency. It alerts you when competitors change strategy and suggests counter-moves.

Troubleshooting Tips

API key not working?
Verify the header format is exact: X-api-key: YOUR_KEY (no extra spaces). Regenerate the key in Settings → Integrations if unsure.

MCP server won't connect?
Check that the URL is https://mcp-agent.synup.com/mcp and restart your AI editor after updating config.

Getting empty results?
Confirm the location ID exists by running get_all_locations. Location IDs are Base64 strings like Location:12345.

Queries timing out?
For 100+ locations, use pagination with the after cursor or query smaller date ranges (7 days vs 90 days).

Headers not recognized?
Verify JSON syntax in your config file (missing commas or quotes cause parse errors). Restart the MCP server after edits.

Only partial data returned?
Check pagination. Large result sets return first 50 by default—use the after cursor from pageInfo to fetch the next page.

Authentication failures on reconnect?
Restart your IDE completely, not just the editor window. Config changes sometimes require a full restart.

Ready to get started? Install Synup MCP, authenticate with your API key, and begin automating your local business management with AI.

Synup MCP

Introduction#

What is MCP?#

Core Details#

Getting Started#

Before You Begin#

Claude Code#

Cursor#

Windsurf#

Authentication#

How to Authenticate#

Getting Your API Key#

Access Modes#

What Can You Do?#

Example Prompts#

Troubleshooting Tips#