Fly Agent MCP

Connect Claude Desktop to Fly Agent's Google Business Profile management tools via MCP (Model Context Protocol).

Perfect for: Local businesses, marketing agencies, and brands managing their Google Business Profiles. Get AI-powered Local SEO insights, automate review responses, track rankings, and publish content - all through natural conversation.

Installation

npm install -g fly-agent-mcp

Setup

1. Get your API Key

1. Log in to fly-social.com
2. Go to Settings → Integrations → API Keys
3. Generate a new API key (starts with fly_sk_...)

2. Configure Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fly-agent": {
      "command": "fly-mcp",
      "env": {
        "FLY_API_KEY": "fly_sk_your_api_key_here"
      }
    }
  }
}

3. Restart Claude Desktop

The Fly Agent tools will now be available in Claude Desktop.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | FLY_API_KEY | Yes | Your Fly Agent API key | | FLY_MCP_URL | No | Custom MCP server URL (advanced use only) |

What You Can Do

Review Management (14 tools)

• Get reviews - See recent reviews, pending replies, search by keyword
• Respond to reviews - Generate AI responses, post replies, batch respond
• Review analytics - Stats, sentiment analysis, QR codes for collecting reviews
• Auto-responder - Configure automatic review responses

Profile Optimization (14 tools)

• Profile audit - Get SEO score, identify optimization opportunities
• Profile updates - Edit business info, hours, description, attributes
• Performance comparison - Compare against competitors
• Profile protection - Monitor unauthorized changes

Content Publishing (9 tools)

• Generate ideas - AI-powered post ideas based on your business
• Create content - Generate post text and images
• Publish posts - Post directly to your GBP
• Manage drafts - Save, edit, schedule posts

Local Rankings (10 tools)

• Track keywords - Monitor your local search rankings
• Ranking trends - See position changes over time
• Competitor analysis - Compare rankings with competitors
• Keyword suggestions - Discover new keywords to track

Performance Analytics (9 tools)

• Performance stats - Views, searches, actions, direction requests
• Trend analysis - Month-over-month comparisons
• Regional breakdown - Performance by location
• KPI dashboards - Executive summaries

Monthly Reports (4 tools)

• Generate reports - Comprehensive monthly performance reports
• Compare periods - Month-over-month analysis
• PDF export - Shareable PDF reports
• Email reports - Send reports to stakeholders

Microsite / Landing Page (32 tools)

• Create microsites - Local landing pages for each location
• Customize design - Themes, sections, SEO settings
• Store locator - Multi-location directory pages
• Custom domains - Connect your own domain

Additional Capabilities

• Search insights - Traffic analytics, keyword performance
• Strategy suggestions - Content calendar, trending topics
• Citations management - Track business listings across the web
• Onboarding - Setup progress, next steps guidance

140+ tools total - ask Claude anything about your local presence!

Example Conversations

For Local Business Owners

You: Show me my recent reviews
You: Reply to the negative review about wait times with an apology
You: What's my current SEO score?
You: Generate a post about our new menu items
You: How am I ranking for "pizza delivery near me"?

For Marketing Agencies

You: List all my client locations
You: Show the review summary for Client ABC's locations
You: Generate a monthly report for downtown location
You: What locations have reviews waiting for replies?
You: Compare performance across all restaurants

For Local SEO Work

You: Run an SEO audit on my profile
You: What keywords should I be tracking?
You: How did my rankings change this month?
You: Generate optimized description with local keywords
You: What's hurting my local visibility score?

Multi-Location Support

Fly Agent supports businesses with multiple locations:

• List locations - See all your connected GBP locations
• Set default - Choose which location to work with
• Per-request - Specify location for any query
• Workspace rollups - Aggregate stats across all locations

Security

• Scoped access - Your API key only accesses your locations
• No cross-tenant data - Queries are isolated to your account
• Revocable keys - Disable API keys anytime from dashboard

Troubleshooting

Claude Desktop hangs on startup

1. Verify Node.js 18+ is installed: node --version
2. Check the fly-mcp command works: FLY_API_KEY=your_key fly-mcp

"Invalid API key" error

1. Verify your API key is correct (starts with fly_sk_)
2. Check it hasn't expired in dashboard
3. Ensure you have at least one location connected

"No accessible locations" error

1. Connect a Google Business Profile at fly-social.com/fly-app
2. Complete the OAuth flow to grant access

Support

• Report issues: GitHub Issues
• Email: [email protected]

License

MIT