Browse the documentation
Use MentionBird.ai in n8n
MentionBird.ai has a verified n8n node. It reads your MentionBird.ai data in any workflow, adds brands and prompts, starts workflows when your visibility changes or new ranking advice is ready, and works as a tool for an n8n AI Agent. An AI Agent can also reach every MentionBird.ai tool at once, writes included, through n8n's built-in MCP Client Tool. Both connect with an API key.
Before you start
Create an API key on the Manage access tab of API & integrations. Keys start with lmvz_live_, and each one belongs to one workspace.
If n8n should make changes, turn on write access when you create the key. See Authentication for which plans include API access.
Install the MentionBird node
The node is the package @mentionbird/n8n-nodes-mentionbird on
npm. Because n8n has verified it, n8n Cloud and self-hosted n8n both offer it in the nodes panel. Only an n8n owner or admin can install it; every member can then use it.
- On the canvas, open the nodes panel with + and search for MentionBird.
- Select MentionBird under More from the community, at the bottom of the panel, then select Install node.
On self-hosted n8n you can also install it from Settings → Community nodes: select Install and enter @mentionbird/n8n-nodes-mentionbird as the npm Package Name.
If MentionBird doesn't appear in the nodes panel, verified community nodes may be turned off for your instance. n8n's guide to installing verified community nodes says where to turn them on.
Connect your key
- Add a MentionBird node to a workflow and create a MentionBird API credential.
-
Paste your key as the API Key, and check that Base URL is
https://api.mentionbird.ai.
Saving the credential tests it by listing your tracked brands. One credential serves the MentionBird node, the MentionBird Trigger and the MentionBird Tool.
What the node does
- The MentionBird node calls the REST API, one operation per endpoint, grouped as Brand, Prompt, AI Platform, Visibility, Citation, Web Search, Answer and YouTube. The Add operations, under Brand and Prompt, need a key with write access. The node's README lists every operation.
- MentionBird Trigger starts a workflow on one of two events for a brand: Visibility Changed, when the brand's visibility on the last complete day moved by at least the minimum change you set, or New Ranking Advice, when a ranking-advice run finished for one of its prompts. It checks MentionBird.ai at most once every 15 minutes.
- MentionBird Tool lets an AI Agent call the node: add it under the agent's Tool input, once per operation the agent should be able to call. For fields such as Brand, choose Let the model define this parameter.
When MentionBird.ai refuses a request, for example for a brand you don't track or an Add operation with a read-only key, the node shows MentionBird.ai's own message.
Or connect an AI Agent through the MCP Client Tool
n8n's built-in MCP Client Tool gives an AI Agent every MentionBird.ai tool through one connection, with nothing to install. It needs n8n 2.3.5 or later, or 1.123.14 or later on the 1.x line. Older versions add their own fields to every tool call, MentionBird.ai refuses those calls, and the agent gets no data. Your version is under the help menu, in About n8n.
- In a new workflow, add an AI Agent node. Click + under its Tool input and add MCP Client Tool.
-
In the MCP Client node, set Endpoint to the URL below and keep Server Transport on HTTP Streamable.
https://mcp.mentionbird.ai/mcp - Set Authentication to Bearer Auth. Under Credential for Bearer Auth, create a credential and paste your key as the Bearer Token.
- Give the agent a chat model, click Open chat and ask something like "Which prompts had zero visibility for my brand in the last 7 days?"
Leave Tools to Include on All, or choose Selected to pick tools from the list n8n loads from MentionBird.ai.
n8n connects with a key. Signing in with your MentionBird.ai account doesn't work from n8n, so skip the MCP OAuth2 option in the Authentication list.
Making changes
Whether you use the node or the MCP Client Tool, making changes needs a key with write access. The node's Add operations add brands and prompts. Through the MCP Client Tool, an agent can:
- track and archive brands;
- add, change and archive prompts;
- add, change and permanently remove tags, competitors, aliases and owned domains;
- start ranking advice and YouTube video summaries, which spend the workspace's credits.
With a read-only key, MentionBird.ai refuses with WRITE_NOT_ALLOWED and the message This API key is read-only. Create a key with write access enabled to use this tool.
If the MCP Client Tool can't connect
n8n shows Error in sub-node 'MCP Client'. Open that node: its output starts with Could not connect to your MCP server. Authentication failed. The message from MentionBird.ai follows, after Error POSTing to endpoint:
- Invalid or revoked API key: the key was mistyped or revoked. Create a new one and paste it into the Bearer Auth credential.
- This workspace is on a plan without API access. Upgrade its plan to connect this app. The key works, but the plan of the workspace it was created in has no API access. Check that workspace's plan on the billing page.