Fixerra Funnel

MCP server wrapping POST /api/v1/dashboards/funnel on admin-api.fixerra.in.

Exposes 4 tools to Cursor / Claude Code for querying FD booking funnel metrics without opening the admin dashboard.

---

Tools

Tool	Purpose
get_funnel	Full-control funnel query — date range, issuer, partner, user segment
get_funnel_today	Today's funnel (auto-dates). Fastest for daily standups
compare_funnel	Two-period side-by-side comparison (WoW, before/after)
check_token_status	Diagnostic — checks if JWT is set and whether it has expired

---

Deployment — Railway

1. Push this repo to GitHub
2. Create a new Railway project → Deploy from GitHub repo
3. Set environment variables in Railway dashboard:

FIXERRA_ADMIN_API_URL = https://admin-api.fixerra.in
FIXERRA_ADMIN_TOKEN   = <paste fresh JWT here>
PORT                  = 3100   (Railway may override this automatically)

4. Railway auto-runs node index.js via railway.toml
5. Health check available at: https://<your-railway-url>/health

Render alternative

• Build command: npm install
• Start command: node index.js
• Health check path: /health
• Same env vars as above

---

Connecting to Cursor

Add to your Cursor mcp.json (same pattern as Integration Hub):

{
  "mcpServers": {
    "fixerra-funnel": {
      "url": "https://<your-railway-url>/mcp",
      "type": "http"
    }
  }
}

---

Auth & Token Rotation

The Fixerra admin JWT expires periodically (check exp claim — currently ~30 days).

On expiry:

1. Log into admin.fixerra.in
2. Open DevTools → Network tab → trigger any dashboard API call
3. Copy the Authorization: Bearer <token> value
4. Update FIXERRA_ADMIN_TOKEN in Railway environment variables
5. Railway will auto-redeploy (or trigger manual redeploy)

Detecting expiry:

• check_token_status tool decodes the JWT locally and shows expires_at and is_expired
• get_funnel / get_funnel_today return a structured TOKEN_EXPIRED error with rotation instructions when the API returns HTTP 401

---

Local Development

cp .env.example .env
# Edit .env with real token

npm install
npm run dev

Test health:

curl http://localhost:3100/health

---

Example Cursor Prompts

What does today's SSFB NTB funnel look like?

Compare this week vs last week for SSFB new users

What's the funnel for partner 6bc99f5e-... for Apr 1–5?

Check if my admin token is still valid