How to integrate Affinity MCP with Atomic Agent

Connect Atomic Agent to Affinity MCP. List all companies added this week, show all opportunities in active pipeline, and more using natural language, with authentication handled for you.

Affinity logoAffinity
Api Key

Affinity is a relationship intelligence CRM that helps private capital investors find, manage, and close more deals. It streamlines deal flow and surfaces key connections to help you win opportunities.

130 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Affinity.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Affinity account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Affinity with

How Atomic Agent connects to Affinity

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Affinity to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Affinity. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Affinity account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Affinity MCP server, and what's possible with it?

The Affinity MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Affinity account. It provides structured and secure access to your relationship and deal data, so your agent can find companies, review people, inspect opportunities, explore lists, and analyze saved views on your behalf.

  • Company research: Have your agent find companies, retrieve detailed company information and custom fields, and review the lists where each company appears.
  • Contact discovery: Let the agent browse people, pull individual profiles and field data, and see each person's related lists and entries.
  • Opportunity review: Direct your agent to list investment opportunities or retrieve the core details of a specific opportunity for deal research.
  • List analysis: Instruct your agent to explore available lists, inspect their fields, and review company, person, or opportunity entries with relevant details.
  • Saved view reporting: Have your agent discover saved views, inspect their setup, and retrieve the matching rows for focused portfolio or pipeline analysis.

Use Affinity from Atomic Agent

With your account connected, ask Atomic Agent to work with Affinity in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Affinity action and event your agent gets out of the box.

Add a List Entry to a List

Beta Affinity API v2 action.

Create a Company Field

Beta Affinity API v2 action.

Create a dropdown option for a List Field

Affinity API v2 action.

Create a List

Affinity API v2 action.

Create a List Field

Beta Affinity API v2 action.

Create an Opportunity

Beta Affinity API v2 action.

Create a Note

Affinity API v2 action.

Create a Person

Beta Affinity API v2 action.

Create a Person Field

Beta Affinity API v2 action.

Create a Reminder

Affinity API v2 action.

Delete a Company Field

Beta Affinity API v2 action.

Delete a dropdown option for a List Field

Affinity API v2 action.

Delete a List Field

Beta Affinity API v2 action.

Delete an Opportunity

Beta Affinity API v2 action.

Delete a Person

Beta Affinity API v2 action.

Delete a Person Field

Beta Affinity API v2 action.

Delete a Reminder

Beta Affinity API v2 action.

Delete a single Note

Affinity API v2 action.

Delete a single Transcript

Beta Affinity API v2 action.

Generate suggested field updates

Beta Affinity API v2 action.

Get a company s list entries

Summarize company data across all lists, including list-specific fields and metadata like creation date and author.

Get a company s lists

Returns metadata for all the Lists on which the given Company appears.

Get a dropdown option for a List Field

Affinity API v2 action.

Get all companies

Request paginated company information, optionally filtering by company IDs and specifying field IDs or types.

Get All Company Duplicate Suggestions

Beta Affinity API v2 action.

Get All Company Merges

Affinity API v2 action.

Get All Company Merge Tasks

Affinity API v2 action.

Get all field value changes

Affinity API v2 action.

Get all Files

Beta Affinity API v2 action.

Get all list entries on a list

Retrieve list entries and entity metadata for companies, persons, or opportunities on a list.

Get all list entries on a saved view

Use the endpoint to access rows in a Saved View with specific filters and selected fields from a web app.

Get all Lists a Team has access to

Beta Affinity API v2 action.

Get all members of a Team

Beta Affinity API v2 action.

Get all Notes

Affinity API v2 action.

Get all opportunities

Pagination through Opportunities in Affinity yields basic info but excludes field data.

Get All Person Duplicate Suggestions

Beta Affinity API v2 action.

Get All Person Merges

Affinity API v2 action.

Get All Person Merge Tasks

Affinity API v2 action.

Get all persons

The Affinity API offers paginated access to Person data using `fieldIds` or `fieldTypes`.

Get all Reminders

Affinity API v2 action.

Get all suggested field update sets

Beta Affinity API v2 action.

Get all suggested field update tasks

Beta Affinity API v2 action.

Get all Transcripts

Affinity API v2 action.

Get all Users

Beta Affinity API v2 action.

Get a person s list entries

Summary: Browse rows for a Person in all Lists, showing field data and entry metadata like creation time and author.

Get a person s lists

Returns metadata for all the Lists on which the given Person appears.

Get a single company

Retrieve basic company info and specific field data by using `fieldIds` or `fieldTypes` parameters.

Get a single field on a Person

Beta Affinity API v2 action.

Get a single field value

Affinity API v2 action.

Get a single field value on a Company

Beta Affinity API v2 action.

Get a single File

Beta Affinity API v2 action.

Get a single List Entry on a List

Affinity API v2 action.

Get a single Meeting

Beta Affinity API v2 action.

Get a single Note

Affinity API v2 action.

Get a single opportunity

Get basic details about an Opportunity without field data via provided endpoints.

Get a single person

Retrieve basic details for a person by ID.

Get a single Reminder

Beta Affinity API v2 action.

Get a single Transcript

Affinity API v2 action.

Get a single User

Beta Affinity API v2 action.

Get a suggested field update set

Beta Affinity API v2 action.

Get a suggested field update task

Beta Affinity API v2 action.

Get Companies attached to a Note

Affinity API v2 action.

Get Company Merge

Affinity API v2 action.

Get Company Merge Task

Affinity API v2 action.

Get Coworker Inferred Connections

Beta Affinity API v2 action.

Get current user

Returns metadata about the current user.

Get dropdown options for a Company Field

Affinity API v2 action.

Get dropdown options for a List Field

Affinity API v2 action.

Get dropdown options for a Person Field

Affinity API v2 action.

Get Field Value Changes on a List Entry

Affinity API v2 action.

Get field values on a single Company

Beta Affinity API v2 action.

Get field values on a single List Entry

Affinity API v2 action.

Get field values on a single Person

Beta Affinity API v2 action.

Get fragments of a transcript

Affinity API v2 action.

Get Introduction Paths

Affinity API v2 action.

Get Investor-Executive Inferred Connections

Beta Affinity API v2 action.

Get metadata on a Company Field

Beta Affinity API v2 action.

Get metadata on a List Field

Beta Affinity API v2 action.

Get metadata on all Calls

Affinity API v2 action.

Get metadata on all Chat Messages

Affinity API v2 action.

Get metadata on all Emails

Affinity API v2 action.

Get metadata on all lists

Returns metadata on Lists.

Get metadata on all Meetings

Affinity API v2 action.

Get metadata on all Teams

Beta Affinity API v2 action.

Get metadata on a Person Field

Beta Affinity API v2 action.

Get metadata on a single list

Returns metadata on a single List.

Get metadata on a single list s fields

Returns metadata on the Fields available on a single List.

Get metadata on a single saved view

Returns metadata on a single Saved View.

Get metadata on a single Team

Beta Affinity API v2 action.

Get metadata on company fields

Returns metadata on non-list-specific Company Fields.

Get metadata on person fields

Returns metadata on non-list-specific Person Fields.

Get metadata on saved views

Returns metadata on the Saved Views on a List.

Get Notes for a Company

Affinity API v2 action.

Get Notes for an Opportunity

Affinity API v2 action.

Get Notes for a Person

Affinity API v2 action.

Get Opportunities attached to a Note

Affinity API v2 action.

Get Person Merge

Affinity API v2 action.

Get Person Merge Task

Affinity API v2 action.

Get Persons attached to a Note

Affinity API v2 action.

Get rate limit usage

Beta Affinity API v2 action.

Get Relationships for a Company

Affinity API v2 action.

Get Relationships for a Person

Affinity API v2 action.

Get replies for a Note

Affinity API v2 action.

Get values for a single field on a Company

Beta Affinity API v2 action.

Get values for a single field on a List Entry

Beta Affinity API v2 action.

Get values for a single field on a Person

Beta Affinity API v2 action.

Initiate Company Merge

Affinity API v2 action.

Initiate Person Merge

Affinity API v2 action.

Perform batch operations on a company's fields

Affinity API v2 action.

Perform batch operations on a list entry's fields

Affinity API v2 action.

Perform batch operations on a person's fields

Affinity API v2 action.

Perform batch operations on suggestions in a set

Beta Affinity API v2 action.

Search Companies

Beta Affinity API v2 action.

Search Files by Keyword

Affinity API v2 action.

Search List Entries

Beta Affinity API v2 action.

Search Notes by Keyword

Affinity API v2 action.

Search Persons

Beta Affinity API v2 action.

Semantic Search

Affinity API v2 action.

Send Feedback

Affinity API v2 action.

Update a Company Field

Beta Affinity API v2 action.

Update a dropdown option for a List Field

Affinity API v2 action.

Update a List Field

Beta Affinity API v2 action.

Update an Opportunity

Beta Affinity API v2 action.

Update a Person

Beta Affinity API v2 action.

Update a Person Field

Beta Affinity API v2 action.

Update a Reminder

Beta Affinity API v2 action.

Update a single field value on a Company

Affinity API v2 action.

Update a single field value on a List Entry

Affinity API v2 action.

Update a single field value on a Person

Affinity API v2 action.

Update a single Note

Affinity API v2 action.

FAQ

Frequently asked questions

Start with Affinity.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Affinity tool your agent needs.Free to start.

Start building