Feather MCP Server

Connect AI agents to Facebook lead generation and CRM automation.

An MCP (Model Context Protocol) server that exposes Feather Connector and Feather Messenger CRM tools to any AI agent. Search leads, manage contacts, send broadcasts, and track growth metrics through a universal plugin interface.

Quick Start

Zero-install via npx:

npx feather-mcp-server

Or install and build locally:

npm install
npm run build
node dist/index.js

Test with the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Demo Mode

Try all 10 tools without installing the Chrome extension!

The server runs in demo mode by default, returning realistic mock data (leads, contacts, stats, growth metrics) so you can explore every tool immediately. Set FEATHER_DEMO=false when you're ready to connect to the live Feather extensions.

Works With

• Claude Desktop — add to claude_desktop_config.json

• Cursor — add as an MCP server in settings

• VS Code — via MCP extension

• Windsurf — add as an MCP server

• OpenClaw — add to your OpenClaw config

• Any MCP client — standard stdio transport

Tools

Feather Connector (Facebook Automation)

Feather Messenger CRM

Analytics

Example Usage

Search for leads

{
  "tool": "search_leads",
  "arguments": {
    "query": "marketing",
    "limit": 5,
    "source": "groups"
  }
}

Send a broadcast

{
  "tool": "send_broadcast",
  "arguments": {
    "label": "warm",
    "message": "New webinar this Thursday! Link in bio.",
    "dryRun": true
  }
}

Check growth

{
  "tool": "get_growth_metrics",
  "arguments": {
    "metric": "connections",
    "period": "30d"
  }
}

Integration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "feather": {
      "command": "npx",
      "args": ["-y", "feather-mcp-server"]
    }
  }
}

OpenClaw

Add to your OpenClaw config:

mcp:
  servers:
    feather:
      command: npx
      args:
        - -y
        - feather-mcp-server

Architecture

src/
  index.ts          Entry point (stdio transport)
  server.ts         MCP server setup + tool registration
  types.ts          TypeScript types
  utils.ts          Helpers (demo mode check, JSON results, error handling)
  tools/
    connector.ts    Feather Connector tools (4 tools)
    messenger.ts    Feather Messenger CRM tools (5 tools)
    analytics.ts    Analytics tools (1 tool)
  mock/
    data.ts         Realistic demo data (leads, contacts, stats, growth series)

Tech Stack

• TypeScript + Node.js

• @modelcontextprotocol/sdk (official MCP SDK)

• zod for input validation

• stdio transport (MCP standard)

License

MIT