Description

n8n-nodes-mentionfox


Community n8n node for MentionFox and FoxAPIs.

This package gives n8n workflows direct access to MentionFox’s research, vetting, dossier, mention-scanning, lead-enrichment, and GEO/AEO scoring tools through the MentionFox MCP (Model Context Protocol) server.

Features

• 8 resources with 30+ operations in a single MentionFox node
• 5 polling triggers for new mentions, high-intent leads, GEO score drops, new battlecards, and crisis signals
• 8 ready-to-import workflow templates in /templates/
• JSON-RPC 2.0 / MCP transport to https://mentionfox.com/mcp
• Bearer-token credential with built-in test endpoint (hits MCP tools/list)

Installation

In your n8n instance, go to Settings → Community Nodes and install:

n8n-nodes-mentionfox

Or, for self-hosted n8n via npm:

npm install n8n-nodes-mentionfox

Authentication

This node uses bearer-token authentication against the MentionFox MCP server.

1. Visit https://mentionfox.com/connect
2. Sign in with your MentionFox account
3. Copy the bearer access token (24-hour expiry; refresh via the same page)
4. In n8n, create a new MentionFox API credential and paste the token

n8n will run a credential test against tools/list on the MCP server. A green check confirms the token is live.

> v0.1 note: full OAuth-grant flow inside the credential editor is on the v1.1 roadmap. v0.1 uses paste-token for simplicity.

Resources

| Resource | Operations |
|—|—|
| Subject | vetperson, getdossier, comparesubjects, evaluateinfluencer |
| Mention | scan, listrecent, scoreintent, getbyid |
| Lead | findcontact, enrichperson, scorelead, pushto_dealflow |
| GEOFixer | runaudit, getscore, listgaps, autopilotstatus, autopilot_toggle |
| Outreach | buildsequence, sendsequence, getsequencestatus, list_replies |
| Chat | startsession, sendmessage, gethistory, exporttranscript |
| Den | listdens, getdenwidgetdata, createdentask, listdentasks |
| Client | listclients, createclient, getclientgeoscore, listclient_battlecards |

Operations whose dedicated MCP tool is pending in v0.1 surface as transparent stubs that return the dashboard URL plus your input arguments unchanged. Workflows wired against stubs light up automatically once MentionFox MCP v1.5 ships dedicated tools — no node version bump required.

See /docs/ for per-resource documentation.

Triggers (5)

| Trigger | What it does |
|—|—|
| On New Mention | Polls scanformentions, dedupes by source URL |
| On New High-Intent Lead | Polls scan + heuristic intent score (above threshold) |
| On GEO Score Drop | Polls getgeofixerscore, fires on N-point drops |
| On New Battlecard Generated | Polls battlecards (stub — heartbeat only in v0.1) |
| On Crisis Signal Detected | Polls scan filtered to crisis keywords; recommended faster cadence |

Worked examples

Example 1: Vet inbound founder leads from HubSpot

1. HubSpot Trigger fires on new contact
2. MentionFox node: Subject → vet_person (founder), pass {{$json.firstname}} {{$json.lastname}}
3. Slack node posts the verdict and public report URL to a channel

Import /templates/01-auto-vet-inbound-founder-leads.json to see the full wiring.

Example 2: Daily GEO health check

1. Schedule trigger at 09:00 daily
2. MentionFox node: GEOFixer → run_audit for your domain
3. MentionFox node: GEOFixer → list_gaps, top 5
4. Notion node logs score; Slack node summarises

Import /templates/02-daily-geo-health-check.json.

Example 3: Reddit signal to personalised outreach

1. MentionFox Trigger (On New High-Intent Lead) on your topic + Reddit only
2. MentionFox node: Lead → find_contact
3. MentionFox node: Outreach → build_sequence (stub in v0.1, returns dashboard URL)
4. Apollo / Instantly HTTP request to send the sequence

Import /templates/03-reddit-signal-personalized-outreach.json.

Workflow templates (8)

Import any of these via n8n’s Workflows → Import from File:

1. 01-auto-vet-inbound-founder-leads.json — HubSpot → MentionFox → Slack
2. 02-daily-geo-health-check.json — Cron → GEO audit → Notion + Slack
3. 03-reddit-signal-personalized-outreach.json — MentionFox Trigger → Find Contact → Build Sequence → Apollo
4. 04-vet-candidate-before-interview.json — Greenhouse webhook → Dossier → conditional Slack red/green
5. 05-compare-conference-speakers.json — Eventbrite webhook → Compare 3 → Notion log
6. 06-crisis-detection-immediate-page.json — Crisis Trigger → Slack page + Linear incident
7. 07-foxchat-conversation-to-den-task.json — FoxChat webhook → Create Den task
8. 08-dossier-as-a-service-sales-calls.json — Calendar 60min before → Dossier → Email rep

Pricing transparency

MentionFox tools cost credits per call. The MentionFox node passes through the same credit charges your account would incur on the dashboard:

| Operation | Cost |
|—|—|
| vet_person (founder) | 200 credits |
| vet_person (investor) | 30 credits |
| get_dossier | 30 credits cold / FREE on cache hit |
| compare_subjects | 5 credits per cached profile |
| Mention scan | 3 credits per source |
| enrich_person | 5 credits |
| savetomy_pipeline | FREE |
| GEOFixer (all ops) | FREE for paid GEOFixer subscribers |

Disambiguation always returns a candidate list at zero credits — you only pay when a real subject is locked in.

Documentation

• Per-resource pages live in /docs/
• Use cases: /docs/use-cases.md
• Reliability tests: /docs/reliability-tests.md
• Performance: /docs/performance.md
• Security audit: /docs/security-audit.md
• Submitting to n8n’s verified community list: /docs/n8n-pr.md

License

MIT

Author

Saul Fleischman / MentionFox

Issues / contact

Open an issue at https://github.com/OsakaSaul/n8n-nodes-mentionfox/issues, or email saul@mentionfox.com.