@faceliftbbt/fds-mcp

fds-mcp — Model Context Protocol (stdio) server for the quintly social media analytics API. Exposes 14 read-only tools that LLMs can use to discover data sources, list profiles/ad-accounts, and run QQL queries.

Install

npm install -g @faceliftbbt/fds-mcp

Requires Node.js ≥ 18.

Authenticate

Same credentials as @faceliftbbt/fds-cli. The server reads:

1. ~/.fds/config.json (created by fds login from the CLI), or
2. FDS_CLIENT_ID / FDS_API_SECRET env vars.

If credentials are missing the server fails fast on stdout-clean stderr.

Wire it up

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "fds": {
      "command": "fds-mcp",
      "env": {
        "FDS_CLIENT_ID": "1234",
        "FDS_API_SECRET": "..."
      }
    }
  }
}

If fds-mcp isn't on your PATH, point at the binary directly:

{
  "mcpServers": {
    "fds": {
      "command": "node",
      "args": ["/absolute/path/to/node_modules/.bin/fds-mcp"],
      "env": { "FDS_CLIENT_ID": "1234", "FDS_API_SECRET": "..." }
    }
  }
}

Claude Code CLI

claude mcp add fds fds-mcp

Available tools

qql                           # run a QQL query (with size-discipline guidance)
list_data_sources             # lightweight index of available networks/tables
describe_data_source          # column schema for one table
list_users / list_spaces
list_profiles / search_profiles / list_pending_profile_auths
list_ad_accounts / list_pending_ad_account_auths
list_use_cases
list_dashboard_share_links
list_data_push_tasks / list_data_push_task_logs

The qql tool description leads with a schema-discovery workflow (list_data_sources → describe_data_source → narrow qqlQuery) and response-size discipline guidance to keep tool results under MCP host caps.

License

MIT