@datafast/mcp-server

An MCP (Model Context Protocol) server that exposes DataFast analytics as tools for AI assistants like Claude, Cursor, and others.

Ask your AI assistant questions like:

• "How many visitors did I get this week?"

• "What are my top referrers this month?"

• "Show me revenue by country for Q4"

• "Which pages have the highest conversion rate?"

• "What's my real-time visitor count?"

Requirements

• Node.js 18.0.0 or later

• A DataFast account with an API key

Related MCP server: Google Analytics MCP Server

Setup

1. Get your API key

Go to your DataFast dashboard → Settings → API Keys and create a new key.

2. Install

npm install @datafast/mcp-server

3. Configure your AI client

Cursor

Add this to your .cursor/mcp.json:

{
  "mcpServers": {
    "datafast": {
      "command": "npx",
      "args": ["-y", "@datafast/mcp-server"],
      "env": {
        "DATAFAST_API_KEY": "df_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "datafast": {
      "command": "npx",
      "args": ["-y", "@datafast/mcp-server"],
      "env": {
        "DATAFAST_API_KEY": "df_your_api_key_here"
      }
    }
  }
}

Windsurf

Add this to your ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "datafast": {
      "command": "npx",
      "args": ["-y", "@datafast/mcp-server"],
      "env": {
        "DATAFAST_API_KEY": "df_your_api_key_here"
      }
    }
  }
}

Available Tools

Analytics

Visitor Details

Tracking

Data Management

Filtering

All analytics tools support powerful filtering:

• UTM parameters: utm_source, utm_medium, utm_campaign, utm_term, utm_content

• Traffic sources: ref, source, via, referrer

• Content: page, entry_page, hostname

• Geography: country, region, city

• Technology: browser, os, device

• Date range: startAt, endAt (ISO 8601)

• Pagination: limit, offset

• Timezone: timezone (IANA format)

Environment Variables

Development

# Install dependencies
npm install

# Build
npm run build

# Type check
npm run typecheck

# Run locally
DATAFAST_API_KEY=df_your_key node dist/index.js

Troubleshooting

"DATAFAST_API_KEY environment variable is required"

Ensure your AI client (Cursor, Claude Desktop, etc.) is configured to pass the DATAFAST_API_KEY in the env object. The key must start with df_.

"Invalid API key format"

DataFast API keys start with df_. Verify you copied the full key from the DataFast dashboard → Settings → API Keys.

MCP server not appearing in Cursor

1. Restart Cursor after adding the MCP config

2. Ensure the config file is at .cursor/mcp.json (or the path your Cursor version expects)

3. Check that npx can resolve @datafast/mcp-server (try running npx -y @datafast/mcp-server in a terminal with DATAFAST_API_KEY set)

API errors

If you see DataFast API error (401), your API key may be invalid or expired. Generate a new key from the dashboard. For DataFast API error (403), check that your API key has the required permissions.

License

MIT