Celavii MCP Server

Connect your Celavii account to AI-powered IDEs and assistants — Windsurf, Cursor, Claude Code, Claude.ai, VS Code + Copilot, Cline, Zed, and more. Supports Instagram and TikTok creators.

Quick Start

1. Get your API key

Go to celavii.com/settings/api-keys and create an API key.

2. Add to your IDE

Windsurf / Cursor / Claude Code / Cline

Add to your MCP config file (~/.cursor/mcp.json, ~/.windsurf/mcp_config.json, etc.):

{
  "mcpServers": {
    "celavii": {
      "command": "npx",
      "args": ["-y", "celavii-mcp@latest"],
      "env": {
        "CELAVII_API_KEY": "cvii_live_your_key_here"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "celavii": {
      "command": "npx",
      "args": ["-y", "celavii-mcp@latest"],
      "env": {
        "CELAVII_API_KEY": "cvii_live_your_key_here"
      }
    }
  }
}

3. Start using it

Ask your AI assistant things like:

• "Find me 20 micro-influencers in Miami interested in fitness"
• "Add these creators to my Summer Campaign list"
• "What's the audience demographics for my campaign?"
• "Enhance these 50 profiles and notify me when done"
• "Show me the network overlap between @nike and @adidas followers"

Available Tools (65)

| Category | Tools | Scope Required | |----------|-------|----------------| | Meta | get_account_info, get_usage | (none) | | Profiles | search_profiles, search_profiles_by_affinities, get_profiles_bulk, get_profile, get_profile_affinities, get_profile_posts, get_profile_network, get_profile_followers, get_profile_following, get_profile_social_links, get_profile_contact | profiles:read, profiles:affinities, profiles:posts, profiles:network, profiles:contact | | Campaigns | list_campaigns, get_campaign_metrics, get_campaign_creators, get_campaign_content | campaigns:read | | Lists | list_lists, create_list, get_list, update_list, delete_list, get_list_members, add_list_members, remove_list_members | lists:read, lists:write | | Analytics | get_demographics, get_locations, get_niches, get_network_overlap, get_shared_hashtags, get_hashtag_creators, get_affinity_posts, analyze_cohort, get_cohort_stats, filter_cohort | analytics:read | | Content | search_content | analytics:read | | CRM | get_managed_profiles, get_crm_summary, get_org_stats, upsert_relationship, delete_relationship | manage:read, manage:write | | Knowledge | list_knowledge_folders, create_knowledge_folder, get_folder_entries, create_knowledge_entry, get_knowledge_entry, update_knowledge_entry, delete_knowledge_entry, search_knowledge | knowledge:read, knowledge:write | | Enhance | enhance_profiles, enhance_bulk, confirm_enhancement, get_enhancement_status | enhance:trigger | | Scrape (Instagram) | scrape_followers, scrape_following, scrape_locations, scrape_hashtags, scrape_urls, get_scrape_status | scrape:trigger | | Scrape (TikTok) | scrape_tiktok_followers, scrape_tiktok_following, scrape_tiktok_hashtags, scrape_tiktok_locations | scrape:trigger | | Refine | refine_profiles, get_refinement_status | refine:trigger |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CELAVII_API_KEY | Yes | Your Celavii API key (cvii_live_...) | | CELAVII_BASE_URL | No | Override the API base URL (default: https://www.celavii.com/api/v1) |

Credits & Rate Limits

Each tool has a credit cost (0-2 credits). Most read operations are free. Search, analytics, and trigger operations cost 1-2 credits.

Rate limits depend on your plan tier:

• Starter: 20 requests/min
• Pro: 60 requests/min
• Enterprise: 300 requests/min

Use get_usage to check your current credit balance and rate limit status.

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
CELAVII_API_KEY=cvii_live_xxx node dist/index.js

License

MIT