MCP Tools Reference
An MCP client sees Funnelfeedr as a set of tools. Your assistant chooses which tool to call based on what you ask. This page lists all 21 of them, so you know what a connected assistant can and cannot do.
Every call runs as the user who approved the connection, inside the account that connection is pointed at. A tool is only available if the connection was granted the right scope, the user holds the right seat, and the user's Funnelfeedr role grants the matching permission. Tools you are not entitled to are hidden from the assistant entirely.
Read tools
All read tools require the Read scope (mcp:read).
| Tool | What it does | Role permission |
|---|---|---|
get_context | The orientation call your assistant makes first: which account the connection is pointed at, that account's own company profile, the contact roles it targets, its ideal customer profiles and scoring profiles, and the other accounts the connection can be moved to. | Any user |
search_organizations | Builds a segment of companies from the Nordic registry. See the filter and ranking summary below. Returns a page with id, organization number, Funnelfeedr URL and, when the search is ranked, a score. | View leads |
find_organization | Looks up companies you can already name — by name, website domain or organization number, up to 25 at a time. Each hit says what your account already has on it: customer, in CRM, exported and to whom, and which lists it is on. | Any user |
get_organization | Full profile of one company: registry, financial and CRM-relationship details. Accepts a Funnelfeedr id, an organization number (SE, NO, DK, FI), a website domain or a Funnelfeedr URL. | Any user |
get_organizations | The same detail for up to 50 companies in one call, and a list of the identifiers that matched nothing. | Any user |
search_contacts | Searches people across companies by seniority and by the profile of the company they work at. Can be narrowed to a shortlist of organizations or to one organization list. Email and phone are masked unless your account has already revealed the contact. | View leads |
get_organization_contacts | Everyone Funnelfeedr knows at one company, ranked as in the web app, with the same masking. | Any user |
list_lists | Your account's organization lists with id, name and size. | View leads |
get_list | The organizations on one list, a page at a time. | View leads |
get_saved_searches | Your saved prospecting searches, optionally with a plain-English summary of what each one filters on. | View leads |
run_saved_search | Runs one saved search by id, with its own filters, market and ranking — including filters search_organizations cannot express. | View leads |
get_filter_vocabulary | The values the exact-match filters accept: tags, technologies, legal forms, municipalities, regions, contact areas and the target contact roles your account has configured. | View leads |
search_knowledge | Semantic search over your company knowledge base: product and pricing details, sales processes, objection handling, positioning, policies. Returns passages with a link to the source entry. | Any user, Conversational Intelligence seat required |
search | ChatGPT Deep Research contract: free-text search returning document ids, titles and citable URLs. | Any user |
fetch | ChatGPT Deep Research contract: full text of one document by id. | Any user |
What search_organizations can do
- Filter by market (one at a time: SE, NO, DK or FI), name, keywords, industry code, municipality, region, city, employee count, revenue, legal form, founding year, web technology and tags.
- Filter by people: companies that employ someone matching your account's target contact roles, or ad-hoc criteria such as "a decision maker in Sales with an email address".
- Filter by your relationship: customers only or excluded, in your CRM only or excluded, companies nobody has touched at all, or companies touched within the last N days.
- Exclude: every filter above has a mirror that disqualifies instead of qualifying, so "manufacturers, but not the ones on this list" is one search.
- Rank by one source at a time: a plain-language description of what you are looking for, one of your ideal customer profiles, a scoring profile, or similarity to one example company.
- Sort by score, revenue, employees or name.
A plain-language description also needs at least one ordinary filter, because the ranking has to score everything the filters leave.
Write tools
Write tools require the Write scope (mcp:write). Most also require the Edit leads permission; the two exceptions are noted.
| Tool | What it does |
|---|---|
create_list | Creates an empty organization list in your account. |
add_organizations_to_list | Adds organizations to an existing list. Additive only. At most 25 per call; the assistant batches larger sets. |
remove_organizations_from_list | Takes organizations off a list, at most 25 per call. This is the one tool marked destructive, so clients such as Claude ask you to confirm before it runs. |
save_search | Saves a set of search_organizations filters as a named saved search you can re-run later. It cannot store a plain-language description; use an ideal customer profile for that. |
create_ideal_customer_profile | Turns a description of your ideal customer into a profile whose id can then rank later searches. Needs no extra role permission, the same as in the web app. |
switch_account | Points the connection at another Funnelfeedr account you are a member of. Takes effect on the assistant's next request. Needs only the Read scope, since it changes nothing in your data. |
There are no other write tools. A connected assistant cannot:
- push organizations or contacts to your CRM
- reveal masked contact details or spend credits
- send email, place calls or schedule anything
- delete or rename lists, or edit an existing saved search
- change settings, users or billing
Asking for the right thing
The assistant picks the tools; you only have to be clear about the job. Some requests that use the newer capabilities:
Are Volvo Group, Scania and Sandvik in our Funnelfeedr, and do we already have them in the CRM?
Find companies like Nordkap Logistik AB in Skåne with 20–100 employees, skip the ones we have already touched this quarter, and put the ten best on a new list.
Rank Gothenburg manufacturers with 50+ employees against our "Mid-market operations" ideal customer profile, and show me the ones with a decision maker in production we have an email for.
Run my saved search "Retail SE – Q3" and tell me which of the top 20 are not in the CRM yet.
Two habits that make answers better: let the assistant call get_context first, so it uses your real ideal customer profiles and target roles instead of guessing, and name a filter you care about rather than only a description — "SaaS companies" alone is too broad to rank.
Accounts
If you belong to several Funnelfeedr accounts, every reply starts with the name of the account it came from, and you can ask the assistant to switch: "switch to Example AB". The change applies from the next request onwards, not to answers already given. You can also change the account from Settings → MCP Connections, which takes up to about two minutes to reach the assistant. See Managing MCP connections.
Seats
| Tier | Tools | Who has it |
|---|---|---|
| Baseline | Everything except search_knowledge | Every user of an active account |
| Conversational Intelligence | search_knowledge | Users with a Conversational Intelligence add-on seat |
An administrator assigns add-on seats under Settings → Subscription → Add-ons. Without the seat, search_knowledge is not listed to the assistant at all.
Rate limits
Limits apply per user, per minute:
| Category | Limit |
|---|---|
| All requests | 60 per minute |
Search tools (search_organizations, find_organization, run_saved_search, search_contacts, search_knowledge, search) | 20 per minute |
Write tools (including switch_account) | 10 per minute |
When a limit is hit the tool returns an error that tells the assistant how long to wait. Assistants normally handle this on their own by pausing and retrying.
Data handling
- Results contain the same data you would see in the Funnelfeedr web app, filtered by your permissions and visibility settings.
- Contact email addresses and phone numbers are masked unless the contact is already revealed in your account. No tool can reveal a contact.
- Every tool call, allowed or denied, is logged with the user, account and application.
- Your assistant's provider (Anthropic, OpenAI and so on) receives the tool results as part of your conversation, under that provider's own terms.