Customer Relation

Affinity MCP Server

Connect your account, then chat with AI to run tools.

Affinity is a relationship intelligence CRM platform designed for deal flow and relationship management. It helps teams track companies, persons, opportunities, and interactions (emails, meetings, calls) to build stronger relationships and close more deals.

32 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Affinity — workflow patterns, data models, and gotchas for your AI agent.

Affinity

Affinity is a relationship intelligence CRM for deal flow and relationship management. Track companies, persons, opportunities, and interactions (emails, meetings, calls).

Data Model

  • Companies, Persons, Opportunities are core entities. Resolve entity IDs from directory reads; use IDs for entry-level and note operations.
  • Lists group rows; each row is an entry on that list. Saved views filter entries without duplicating underlying companies or people.
  • Notes attach to companies, persons, or opportunities. Chats are conversation threads.
  • Fields define schema for companies, persons, and lists. Custom fields vary by workspace.
  • Dashboards (activity hub, pipeline health, CRM quality, dealflow funnel/geography/industry) return pre-built analytics.
  • Stable resource handles for read-by-id flows look like affinity:company:{id} or affinity:person:{id}; narrow payloads with field_ids or field_types when you do not need every column.

Gotchas

  • v2 API: Every path is /v2. Read-by-id operations accept selective field projections—use them to keep responses small.
  • Batch entry updates: Multiple field mutations can be applied in a single round trip when the API allows it.
  • Interaction data: Emails, meetings, calls appear as relationship-intelligence fields on entities, not standalone endpoints.

Tools in this Server (32)

Affinity Batch Update Fields

Update multiple fields on a list entry in a single request. More efficient than updating fields one at a time. Supports all field types. Requires 'Exp...

Affinity Get Chats

List all chat message interactions tracked in Affinity. Returns chat message metadata including participants, content, date, and associated entities.

Affinity Get Companies

Paginate through all companies/organizations in Affinity. Returns basic information and non-list-specific field data. Supports field selection by IDs ...

Affinity Get Company Entries

List all list entries (rows) for a specific company across all lists. Returns detailed field data including list-specific fields for each list the com...

Affinity Get Company Fields

Get metadata on all non-list-specific company fields. Returns field IDs, names, types, enrichment sources, and data types. Use these Field IDs with af...

Affinity Get Company Lists

List all lists that contain a specific company. Returns list metadata for each list the company appears on.

Affinity Get Company Notes

List all notes attached to a specific company. Returns note metadata including content, creator, and creation date.

Affinity Get List Entries

Paginate through all list entries (rows) on a specific list. Returns detailed field data including list-specific fields. This is the primary endpoint ...

Affinity Get List Fields

Get metadata on all fields for a specific list. Returns field IDs, names, types, enrichment sources, and data types. Includes enriched, global, relati...

Affinity Get Lists

List all lists/spreadsheets in Affinity. Returns list metadata including ID, name, type (company/person/opportunity), and other configuration.

Affinity Get Note Companies

List all companies directly attached to a specific note. Returns company metadata including ID, name, domain, and domains list. This endpoint is in BE...

Affinity Get Note Opportunities

List all opportunities directly attached to a specific note. Returns opportunity metadata including ID, name, and list ID. This endpoint is in BETA.

Affinity Get Note Persons

List all persons directly attached to a specific note. Returns person metadata including ID, name, email addresses, and type. This endpoint is in BETA...

Affinity Get Note Replies

List all reply notes for a specific note. Returns note metadata including content, creator, creation date, and mentions. Supports filtering by creator...

Affinity Get Notes

List all notes in Affinity. Returns note metadata including content, creator, creation date, and attachments.

Affinity Get Opportunities

List all opportunities/deals in Affinity. Returns only basic data (name and list ID). For full opportunity data with field values, use affinity_list_l...

Affinity Get Opportunity Notes

List all notes attached to a specific opportunity. Returns note metadata including content, creator, and creation date.

Affinity Get Person Entries

List all list entries (rows) for a specific person across all lists. Returns detailed field data including list-specific fields for each list the pers...

Affinity Get Person Fields

Get metadata on all non-list-specific person fields. Returns field IDs, names, types, enrichment sources, and data types. Use these Field IDs with aff...

Affinity Get Person Lists

List all lists that contain a specific person. Returns list metadata for each list the person appears on.

Affinity Get Person Notes

List all notes attached to a specific person. Returns note metadata including content, creator, and creation date.

Affinity Get Persons

Paginate through all persons/contacts in Affinity. Returns basic information and non-list-specific field data. Supports field selection and cursor-bas...

Affinity Get Saved Views

List all saved views for a specific list. Returns saved view metadata including name, filters, and field configuration.

Affinity Get View Entries

List entries from a saved view. Returns only the fields configured in the saved view and respects the saved view's filters set in the Affinity web app...

Affinity Initiate Company Merge

Initiate a company merge to combine duplicate companies. The source company will be merged into the target company. Merge operations are asynchronous ...

Affinity Initiate Person Merge

Initiate a person merge to combine duplicate persons. The source person will be merged into the target person. Merge operations are asynchronous - use...

Affinity List Company Merges

List all company merge statuses. Returns merge metadata including source/target companies, status, and creation date. BETA endpoint.

Affinity List Company Merge Tasks

List all company merge tasks. Use this to check the status of initiated company merges. Returns task metadata including status, progress, and any erro...

Affinity List Person Merges

List all person merge statuses. Returns merge metadata including source/target persons, status, and creation date. BETA endpoint.

Affinity List Person Merge Tasks

List all person merge tasks. Use this to check the status of initiated person merges. Returns task metadata including status, progress, and any errors...

Affinity Update Entry Field

Update a single field value on a list entry. Supports all field types including text, number, dropdown, datetime, person-multi, company-multi, and ass...

Fetch

Universal fetch tool that retrieves ANY Affinity API v2 resource using smart ID routing with colon-separated format. Supports all GET endpoi...

Frequently Asked Questions

What is the Affinity MCP server?

Affinity is a relationship intelligence CRM platform designed for deal flow and relationship management. It helps teams track companies, persons, opportunities, and interactions (emails, meetings, calls) to build stronger relationships and close more deals. It provides 32 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Affinity to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/affinity. Authentication is handled automatically.

How many tools does Affinity provide?

Affinity provides 32 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Affinity require?

Affinity uses API Key. Affinity requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Affinity to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/affinity

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to use Affinity?

Sign in to connect your credentials and start running tools from the chat.

Affinity MCP Server & Skill — 32 Tools