MartechDB
MartechDB
Toggle sidebar

Affinity CRM MCP server

affinity.co

Yes. Affinity CRM publishes an official MCP server at https://mcp.affinity.co/mcp. It's hosted and needs an OAuth app that you set up in Affinity CRM first. It offers 97 tools. We last checked it on 22 Nov 2026.

Official MCP server
Hosted
Sign-in needs vendor setup

Official: answers MCP requests at mcp.affinity.co, on Affinity CRM's own domain affinity.co. Checked 22 Nov 2026. Maintained by Stuart Brameld.

Key facts

As of 22 Nov 2026, Affinity CRM's official MCP server scores 75/100 on MartechDB's Agent Readiness Index (v1.1), joint 27th of 37 in CRM. It answered 56 of our 56 checks in the last 90 days and lists 97 tools.

How the Agent Readiness Index works · Wrong? Suggest a correction

Affinity CRM MCP server review

75/100

Affinity CRM's MCP server scores 75/100 on MartechDB's Agent Readiness Index: easy to connect an AI agent to, with a few gaps. That ranks it joint 27th of 37 in CRM.

The good

  • Hosted by Affinity CRM: connect by URL, with nothing to install

  • Documented, with 97 tools known

  • Answered 100% of our checks in the last 90 days

The bad

  • Signing in needs an app registered with Affinity CRM first

  • Needs a paid plan, with no free trial

  • Agent access costs more than the base plan

Official MCP server

Affinity CRM MCP server

Address
https://mcp.affinity.co/mcp
Runs
Hosted
Sign-in
Sign-in needs vendor setup
Cost to use
Plan: Scale, Advanced, and Enterprise plans · No free access · Costs more than the base plan
From Affinity CRM's own page, pricing from this page
Official MCP Registry
Not listed
How we know it's official
  • Answers MCP requests at mcp.affinity.co, on Affinity CRM's own domain affinity.co.
Checked 22 Nov 2026.
Tools
97 tools · listed 22 Nov 2026
First seen
1 Oct 2026
Last checked
Reachable ·
16 Nov 2026: reachable
17 Nov 2026: reachable
18 Nov 2026: reachable
19 Nov 2026: reachable
20 Nov 2026: reachable
21 Nov 2026: reachable
22 Nov 2026: reachable
Uptime
100% · 56 of 56 checks reachable since 1 Oct 2026

Affinity CRM MCP server tools (97)

As the server lists them. Names and descriptions are the vendor's own.

  • get_current_user
    Read-only

    Get information about the current user. Use this tool to verify authentication and understand available API access levels. Returns: Information about the user, their current organization, and API key permissions, plus `access`: "read-write" or "read-only". Report `access` as the user's access level. Do not infer it from individual scope names: "mcp.read" is a sub-scope that is also granted alongside the read-write "mcp" scope. `access` is absent when the grant carries no recognized scope.

  • search_companies_top_matches
    Read-only

    Search companies using natural language, structured criteria, or both simultaneously. When query and search_criteria are provided, both semantic search and structured search run in parallel and results are merged. Call get_company_info for richer field data on results. DEFAULT for all company lookups, including structured-only filters with no semantic query. Only route to search_all_companies() when the request contains an explicit exhaustive-intent word such as "all", "every", "full list", "complete list", or "export", or when the user needs field data returned inline with results or a total count. Use this tool when discovery phrasing is present ("what companies", "which companies", "find companies", "show me companies"). RULE 1 - EXACT NAME OR DOMAIN LOOKUP (check this FIRST): If the request is to find one specific company by its name or domain ("find Stripe", "look up stripe.com", or resolving a company name to an ID before calling another tool), pass ONLY search_criteria and OMIT…

  • search_all_companies
    Read-only

    Paginate exhaustively through companies using structured filters, sorts, and/or a keyword. Use this tool when: - The request signals exhaustive intent ("all", "every", "full list", "export") - The user needs field data returned inline with results (field_ids or field_types) - The user needs a total count of matching companies (total_count=True) - Paginating through a complete result set from a previous call For all other searches, including structured-only filters, use search_companies_top_matches() instead. Omitting search_criteria returns every company with default pagination. FIELD SELECTION: field_ids and field_types are mutually exclusive; passing both raises ValueError. Valid field_types are enriched, global, and relationship-intelligence. When both are omitted, only company identity (id, name, domain, domains, isGlobal) is returned. DISCOVERING FIELDS: Use get_entity_fields(entity_type=EntityType.COMPANY, includes=[FieldInclude.FILTERABILITY, FieldInclude.SORTABILITY]) to find…

  • get_company_info
    Read-only

    Returns basic information and non-list specific field data on the requested company. By default, returns all field data including location, description, and more. Use get_entity_fields tool if you need to filter to specific fields. IMPORTANT: field_ids and field_types are mutually exclusive. They cannot be used together. Args: company_id (required): The ID of the company field_ids: List of field IDs to return. field_types: List of field types to return. Defaults to ['enriched', 'global', 'relationship-intelligence'] Returns: Metadata about the specified company including field data. A field on an opportunity you can't manage may come back with type "hidden" and a masked value.

  • get_company_list_entries
    Read-only

    Fetches list entries for the given company. Args: company_id (required): The ID of the company cursor: Cursor for the next or previous page. Pass the value of `pagination.nextCursor` or `pagination.prevCursor` from a prior response. Do NOT parse or modify the cursor string. limit: The number of items to include in the page. Default is 100, max is 100 Returns: A dict with `data` (list of list entries) and `pagination` with `nextCursor` / `prevCursor` strings (pass directly to the `cursor` param; absent when there is no such page) and `nextUrl` / `prevUrl` full URLs (null when there is no such page).

  • get_merge_task
    Read-only

    Checks whether a company or person merge has finished, by its task id. Use after merge_companies or merge_persons returned with confirm=true: both return a task_id, and this reads GET /v2/tasks/<entity>-merges/{task_id} once. It does not poll. A merge can stay "in-progress" for several minutes while Affinity retries it; read again when the user asks. "failed" is final. IMPORTANT: entity_type must match the tool that produced the task: a company task read as "person" (or the reverse) is a 404, the same as an unknown id. Requires the Manage Duplicates permission and organization admin role, like the merge tools; a token without it gets a 403. Args: task_id (required): The task_id returned by merge_companies or merge_persons, a UUID such as "76251d92-99e1-416f-a3d2-0935435eb672". Anything that is not a UUID raises ValueError before any API call. entity_type (required): "company" for a merge_companies task, "person" for a merge_persons task. Returns: {"task_id", "entity_type", "status", "…

  • render_market_map
    Read-only

    Render an investment thesis market map as an interactive scatter plot and coverage tables. IMPORTANT: only call this after searching Affinity (and optionally the web) for companies matching the thesis and scoring each for thesis fit, per the market-map-generator skill. This tool does not search, score, or classify anything itself. It draws exactly the companies it is given, so pass the same de-duplicated, quality-filtered results already shown to the user in text. Never invent a company, score, or funding figure not already in those results. Args: thesis: The investment thesis being visualized. your_companies: Companies with interaction history ("tracked" or "org-relevant" source only), plotted on the scatter and listed in the "Your Companies" table. Maximum 20. explore_companies: Companies with no interaction history ("global-cold" or "web" source only), listed in the "Companies to Explore" table only. Maximum 20. Must not repeat a domain already present in `your_companies` - de-dupl…

  • get_entity_fields
    Read-only

    Returns metadata on non-list specific company or person fields. Args: entity_type: Type of entity to return fields for. Options: 0 = person, 1 = company cursor: Cursor for the next or previous page. Pass the value of `pagination.nextCursor` or `pagination.prevCursor` from a prior response. Do NOT parse or modify the cursor string. limit: The number of items to include in the page. Default is 100, max is 100. filter: Filter fields by name. `name` is the only filterable property. Two operators, both case-sensitive, so match the field's actual capitalization: - Exact match: name="Location" - Substring match: name=~"Funding" Wrap any value containing spaces in double quotes, e.g. name=~"Last Funding" Combine clauses with & (AND), | (OR), ! (NOT) and parentheses, e.g. name=~"Funding" | name="Location" includes: Extra per-field metadata to return, omitted by default. Request these before building a search_companies_top_matches, search_all_companies, or search_persons filter or sort to confi…

  • get_list_fields
    Read-only

    Returns metadata on fields available for a given list. Args: list_id: ID of list to return fields for. cursor: Cursor for the next or previous page. Pass the value of `pagination.nextCursor` or `pagination.prevCursor` from a prior response. Do NOT parse or modify the cursor string. limit: The number of items to include in the page. Default is 100, max is 100. filter: Filter fields by name. `name` is the only filterable property. Two operators, both case-sensitive, so match the field's actual capitalization: - Exact match: name="Location" - Substring match: name=~"Funding" Wrap any value containing spaces in double quotes, e.g. name=~"Last Funding" Combine clauses with & (AND), | (OR), ! (NOT) and parentheses, e.g. name=~"Funding" | name="Location" includes: Extra per-field metadata to return, omitted by default. Request these before building a search_list_entries filter or sort to confirm the field supports the operator and ordering you intend. - FieldInclude.FILTERABILITY: how the fi…

  • get_list_field_dropdown_options
    Read-only

    Returns the dropdown options for a specific dropdown, ranked-dropdown, or status-dropdown field on a list. Use the returned dropdown option IDs when writing dropdown field values via upsert_list_entry_field_values. A status-dropdown option additionally carries `rank`, `color`, `statusCategory` (one of "open", "won", "lost", "on-hold"), and `winRate` (0-100, only set when statusCategory is "open"). Args: list_id: ID of list field_id: human-readable string ID of field to return options for (ex. "field-123") cursor: Cursor for the next or previous page. Pass the value of `pagination.nextCursor` or `pagination.prevCursor` from a prior response. Do NOT parse or modify the cursor string. limit: The number of items to include in the page. Default is 20, maximum is 100. Returns: A dict with `data` (metadata about each dropdown option) and `pagination` with `nextCursor` / `prevCursor` strings (pass directly to the `cursor` param; absent when there is no such page) and `nextUrl` / `prevUrl` ful…

Affinity CRM doesn't let AI tools sign in on their own. Create an app (or ask your admin to) in your Affinity CRM account first, then use its client ID and secret when your AI client asks.

Connect your AI to Affinity CRM

Add the official Affinity CRM MCP server to Claude, ChatGPT or your editor.

Connect Affinity CRM MCP to Claude

Claude.ai and Claude Desktop

  1. Open Customize, then Connectors.

  2. Click +, then Add custom connector.

  3. Name it Affinity CRM, paste the address below and click Add.

Claude Code

Affinity CRM MCP server questions

Does Affinity CRM have an official MCP server?

Yes. Affinity CRM publishes its MCP server itself. Its address is on Affinity CRM's own domain (mcp.affinity.co). MartechDB only lists servers a vendor publishes, never community copies.

What is the Affinity CRM MCP server URL?

The address is https://mcp.affinity.co/mcp.

Does the Affinity CRM MCP server need an API key?

No, but it needs set-up first: it signs in with OAuth through an app you (or an admin) create in your Affinity CRM account.

How do I connect Affinity CRM MCP to Claude, ChatGPT or Cursor?

In Claude, add https://mcp.affinity.co/mcp as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http affinity-crm https://mcp.affinity.co/mcp

What can the Affinity CRM MCP server do?

It offers 97 tools, including get_current_user, search_companies_top_matches, search_all_companies, get_company_info and get_company_list_entries (as listed on 22 Nov 2026). 62 are marked read-only and 22 can delete or overwrite data.

Is the Affinity CRM MCP server in the official MCP Registry?

No. Affinity CRM hasn't published it to the official MCP Registry.

Is the Affinity CRM MCP server free to use?

No, it needs a paid plan. Plan needed: Scale, Advanced, and Enterprise plans. It costs more than the base plan. From Affinity CRM's own pages, checked on 7 Oct 2026.

Is the Affinity CRM MCP server working?

Yes. It answered our most recent check. We last checked it on 22 Nov 2026.

What are the alternatives to Affinity CRM's MCP server?

In CRM, the most agent-friendly alternatives with an official MCP server are Attio (97/100), Zero (97/100), Pipedrive (96/100), NetHunt (95/100) and Twenty (94/100). Affinity CRM scores 75/100 on the same index.

Alternatives to Affinity CRM's MCP server

Vendors in CRM with an official MCP server, the most agent-friendly first. Affinity CRM scores 75/100.

Compare all 55 CRM vendors →

Change history

What we've seen change for Affinity CRM, newest first.

  1. Affinity CRM: Affinity CRM MCP server: 1 tool added (now 97)

Use with AI

Connect your AI to MartechDB

Then ask it about Affinity CRM, or any of the 1,850 marketing tools with an official MCP server. Free, no sign-in.

Claude.ai and Claude Desktop

  1. Open Customize, then Connectors.

  2. Click +, then Add custom connector.

  3. Name it MartechDB, paste the address below and click Add. There's no sign-in.

The free plan allows one custom connector. On Team and Enterprise plans, an owner adds the connector first.

Show that your MCP server is verified

If you work at Affinity CRM, add this badge to your MCP docs or README. It's free, it's the same for every vendor, and it updates from our daily checks: it shows uptime while the server responds, and says so if it stops.

Official MCP server, verified by MartechDB
HTML
Markdown

Something wrong or out of date? Suggest a correction or email us, and we'll check it against the evidence. Every correction we make is listed on Corrections.