@gtmconductor/mcp

MCP (Model Context Protocol) server for GTM Conductor. Control your entire GTM funnel directly from Claude Code.

What is this?

This package provides an MCP server that connects Claude Code to your GTM Conductor account. Once connected, Claude can:

• Create and manage lead magnets with AI-powered content generation
• Build and publish funnel pages
• Run cold email campaigns (upload leads, enrich, launch)
• Schedule and publish content
• View analytics across all your GTM activities
• Manage multiple clients (for agencies)

Quick Start

npx @gtmconductor/mcp init

This interactive command will:

1. Ask for your GTM Conductor API key
2. Configure Claude Code to use the MCP server
3. Add the GTM workflow skill for guided assistance

After running init, restart Claude Code to activate.

Prerequisites

• Node.js 18+
• Claude Code installed
• GTM Conductor account with API key

Getting Your API Key

1. Log in to GTM Conductor
2. Go to Settings > API Keys
3. Click "Create API Key"
4. Copy the key (starts with gtm_)

Manual Configuration

If you prefer to configure manually, add to ~/.claude/settings.json:

{
  "mcpServers": {
    "gtmconductor": {
      "command": "npx",
      "args": ["@gtmconductor/mcp", "serve"],
      "env": {
        "GTM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Lead Magnets

• gtm_list_lead_magnets - List your lead magnets
• gtm_get_lead_magnet - Get details of a specific lead magnet
• gtm_ideate_lead_magnets - Generate lead magnet ideas
• gtm_create_lead_magnet - Create a new lead magnet
• gtm_get_extraction_question - Get the next knowledge extraction question
• gtm_generate_content - Generate lead magnet content
• gtm_write_linkedin_posts - Generate LinkedIn posts for promotion

Funnel Pages

• gtm_list_funnel_pages - List your funnel pages
• gtm_get_funnel_page - Get funnel page details
• gtm_create_funnel_page - Create a new funnel page
• gtm_update_funnel_page - Update funnel page settings
• gtm_publish_funnel_page - Publish a funnel page
• gtm_unpublish_funnel_page - Unpublish a funnel page

Cold Email Campaigns

• gtm_list_campaigns - List your campaigns
• gtm_get_campaign - Get campaign details
• gtm_create_campaign - Create a new campaign
• gtm_upload_leads - Upload leads to a campaign
• gtm_enrich_leads - Enrich leads with additional data
• gtm_launch_campaign - Launch a campaign
• gtm_pause_campaign - Pause a running campaign
• gtm_get_campaign_stats - Get campaign statistics
• gtm_list_replies - List campaign replies
• gtm_classify_reply - Classify a reply

Content

• gtm_list_content - List your content
• gtm_get_content - Get content details
• gtm_create_content - Create new content
• gtm_update_content - Update existing content
• gtm_schedule_content - Schedule content for publishing
• gtm_publish_content - Publish content immediately
• gtm_generate_content_ideas - Generate content ideas
• gtm_repurpose_content - Repurpose content to different formats
• gtm_get_content_calendar - View your content calendar

Analytics

• gtm_get_dashboard - Get dashboard overview
• gtm_get_lead_magnet_analytics - Lead magnet performance
• gtm_get_funnel_analytics - Funnel page performance
• gtm_get_campaign_analytics - Campaign performance
• gtm_get_content_analytics - Content performance
• gtm_get_lead_sources - Lead source breakdown
• gtm_export_analytics - Export analytics data

Multi-tenant (Agencies)

• gtm_list_clients - List your agency clients
• gtm_get_client - Get client details
• gtm_set_client - Switch to a client context
• gtm_clear_client - Clear client context (back to agency)
• gtm_get_current_context - Get current user/client context

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | GTM_API_KEY | Your GTM Conductor API key | Yes | | GTM_BASE_URL | API base URL (for development) | No |

Commands

# Start the MCP server (usually called by Claude Code)
npx @gtmconductor/mcp serve

# With explicit API key
npx @gtmconductor/mcp serve --api-key gtm_your_key

# Initialize Claude Code configuration
npx @gtmconductor/mcp init

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode for development
npm run dev

Documentation

For full documentation, see GTM Conductor MCP Setup Guide.

License

MIT