npm package: @gtmconductor/mcp
Description: MCP server for GTM Conductor - control your entire GTM funnel from Claude Code
Author: GTM Conductor
Latest version: 0.2.0

# @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

```bash
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](https://gtmconductor.com)
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`:

```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

```bash
# 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

```bash
# 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](https://gtmconductor.com/docs/mcp).

## License

MIT