@aivora/mcp-server

MCP (Model Context Protocol) server for Aivora — manage your social media, content, leads, SEO, analytics, email campaigns, and workflows from any AI agent.

Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Install

Option A: Global install (available everywhere)

npm install -g @aivora/mcp-server

Option B: No install (use via npx)

Skip the install entirely — npx downloads and runs it on demand. See setup below.

Quick Setup

1. Get an API key

Log into Aivora → Settings → API Keys → Create key.

2. Configure your MCP client

Claude Code (recommended)

Run this one-liner to register the MCP server:

claude mcp add aivora \
  -e AIVORA_API_KEY=ak_your_api_key_here \
  -e AIVORA_API_URL=https://staging-api.getaivora.co \
  -- npx @aivora/mcp-server

If you installed globally and aivora-mcp is in your PATH, you can use it directly instead of npx:

claude mcp add aivora \
  -e AIVORA_API_KEY=ak_your_api_key_here \
  -e AIVORA_API_URL=https://staging-api.getaivora.co \
  -- aivora-mcp

Restart Claude Code, then check /mcp — you should see aivora · ✔ connected.

Manual config (Claude Code, Cursor, Windsurf)

Add to your MCP config file (.mcp.json for Claude Code, MCP settings for Cursor/Windsurf):

Using npx (no install needed):

{
  "mcpServers": {
    "aivora": {
      "command": "npx",
      "args": ["@aivora/mcp-server"],
      "env": {
        "AIVORA_API_KEY": "ak_your_api_key_here",
        "AIVORA_API_URL": "https://staging-api.getaivora.co"
      }
    }
  }
}

Using global install:

{
  "mcpServers": {
    "aivora": {
      "command": "aivora-mcp",
      "env": {
        "AIVORA_API_KEY": "ak_your_api_key_here",
        "AIVORA_API_URL": "https://staging-api.getaivora.co"
      }
    }
  }
}

3. Use it

Ask your AI agent things like:

• "Schedule a LinkedIn post for tomorrow at 9am"
• "Generate 5 Instagram captions about our product launch"
• "Run an SEO audit on our website"
• "Show me analytics for the last 7 days"
• "Create an email campaign for our new feature"
• "Find leads in the SaaS industry"

Available Tools

| Category | Tools | Description | |----------|-------|-------------| | Social Media | schedule_post, get_scheduled_posts, delete_post, get_connected_accounts | Schedule, manage, and track social posts across 13 platforms | | Content | generate_content, generate_image, generate_video, analyze_brand | AI-powered content creation and brand analysis | | Leads | scrape_leads, enrich_lead, get_leads | Lead generation, enrichment, and management | | SEO | seo_audit, keyword_research | Website audits and keyword analysis | | Analytics | get_analytics, get_post_performance | Cross-platform analytics and post metrics | | Email | send_campaign, get_campaigns, manage_recipients | Email campaign creation and management | | Workflows | list_workflows, create_workflow, run_workflow, get_templates | Multi-step workflow automation |

Transports

stdio (default) — for local MCP clients like Claude Code:

npx @aivora/mcp-server

HTTP + SSE — for remote connections:

npx @aivora/mcp-server --transport http --port 3001

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AIVORA_API_KEY | Yes | Your Aivora API key (ak_...) | | AIVORA_API_URL | Yes | Aivora API base URL |

Troubleshooting

MCP server shows "failed" in Claude Code

1. Test that the server starts:

AIVORA_API_KEY=ak_test AIVORA_API_URL=https://staging-api.getaivora.co npx @aivora/mcp-server

If it hangs with no output, it's working (waiting for stdio input). Press Ctrl+C to exit.

If it prints an error like AIVORA_API_KEY environment variable is required, your env vars aren't being passed correctly.

2. aivora-mcp: command not found after global install

Your npm global bin directory may not be in your PATH. Use npx instead:

claude mcp remove aivora
claude mcp add aivora \
  -e AIVORA_API_KEY=ak_your_key \
  -e AIVORA_API_URL=https://staging-api.getaivora.co \
  -- npx @aivora/mcp-server

3. Server connects but tools return errors

• Verify your API key is valid: go to Aivora → Settings → API Keys and check it's active
• Verify the API URL is correct (https://staging-api.getaivora.co)
• Check that your Aivora account has an active subscription

4. npm ERR! 404 Not Found when installing

Clear the npm cache and retry:

npm cache clean --force
npm install -g @aivora/mcp-server

5. Still not working?

Open an issue at github.com/JaamesBond/Aivora-infra/issues with:

• Your OS and Node.js version (node -v)
• The exact error message
• Output of npx @aivora/mcp-server with env vars set

License

MIT