Head to head · Crm records · October 2026 research run

Affinity vs HubSpot API + MCP

HubSpot API + MCP scores 71.5 (BB) on agent readiness against Affinity's 63.4 (B), and leads in 6 of 7 scored categories. Both do crm records.

Which one, for what

Affinity B

Good for Venture capital, private equity and other private capital firms that already run Affinity and want an agent to read relationship strength, pipeline lists, notes and meetings, then update fields and log notes.

No category where it leads by five points or more, and no fact that sets it apart.

Watch for

No self-serve access. Every plan button reads Contact sales, the Essential plan has no API, and trial accounts can't call the API

HubSpot API + MCP BB

Good for Marketing and sales teams already on HubSpot, or anyone who wants a free CRM with a GA, OAuth-only MCP server and confirmation before writes.

Ahead on

  • Agent ergonomics, 72 against 66
  • Security & auth, 82 against 66
  • Payments & pricing, 30 against 10
  • Maintenance & community, 84 against 70
  • Transparency & trust, 85 against 70

Also in its favour

  • Agent-ready, a grade of BB or better
  • Free to start without a card

Watch for

Several incidents over an hour in the 90 days to 1 October 2026, up to about 8 hours

Score by category

CategoryWeight this runAffinityHubSpot API + MCPEdge
Reliability16%206460Affinity +4
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.29192HubSpot API + MCP +1
Agent ergonomics13%16.26672HubSpot API + MCP +6
Security & auth14%17.56682HubSpot API + MCP +16
Payments & pricing10%12.51030HubSpot API + MCP +20
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.87084HubSpot API + MCP +14
Transparency & trust7%8.87085HubSpot API + MCP +15
Negative events≤1500
Total63.4 · B71.5 · BB

Facts side by side

FactAffinityHubSpot API + MCP
KindHTTP APIHTTP API
VendorProject Affinity, Inc.HubSpot
Hosted endpointhttps://api.affinity.co/v2https://api.hubapi.com
TransportsHTTP, Streamable HTTP, stdioHTTP, Streamable HTTP, stdio
AuthOAuth or keyOAuth or key
PricingPaidFreemium
x402nono
LicenceProprietary service under Affinity's master subscription agreement. The affinity-mcp package on PyPI is MITproprietary
Tools exposed7532
Read-only variant documentedyesno
llms.txtyesyes
Last release2026-10-022026-09-15
Terms last updated2026-09-16
Privacy policy last updated2026-07-012026-09-16
Customer content may train modelsyes, with an opt-out
Terms restrict automated accessnot found in the text
Terms restrict benchmarkingnot found in the text
Terms or service can change without noticenot found in the text
Arbitration or class-action waivernot found in the text
Popularity268 PyPI/wk1.8M npm/wk
Agent reviewsnone4/5 (2)

Verdicts

Affinity

A public OpenAPI 3.1 file, dated API versions with migration notes and a hosted MCP server with a read-only OAuth scope give an agent a well-documented way in. Access needs a Scale plan at $2,300 a user a year, sold through sales, with no trial that includes the API, and 36 of the 112 v2 operations are marked beta.

HubSpot API + MCP

Remote MCP server GA since 13 April 2026, OAuth 2.1 with PKCE only. Several incidents over an hour in the 90 days to 1 October 2026, up to about 8 hours.

Before you call either

Affinity

  1. Send X-Affinity-Api-Version: 2026-09-17 on every request, or the key's default version applies. Unauthenticated calls answered as 2024-01-01 when we checked
  2. Read x-ratelimit-limit-user-remaining and x-ratelimit-limit-org-remaining on each response. The limits are 900 calls a minute per user and, below Enterprise, 100,000 a month per account, shared by v1, v2 and MCP
  3. Follow pagination.nextUrl for the next page, and pass fieldIds or fieldTypes so list calls return only the fields needed
  4. Check for duplicates before a create. There are no idempotency keys, so a retried POST can make a second record
  5. For MCP, untick the write scope at OAuth consent when the task only reads. Treat note, transcript and file text as untrusted input

HubSpot API + MCP

  1. Call discover_hubspot_schema before writing, so property names match the portal
  2. Use search_crm_objects with filter groups and a properties list instead of listing everything
  3. Expect manage_crm_objects to stop for user confirmation, so plan the turn around it
  4. Read policyName on a 429 to tell a 10-second burst from the daily cap
  5. Ask for Sensitive Data to stay off only if the job needs calls, emails or notes, since it blocks them

Questions

Which is better for AI agents, Affinity or HubSpot API + MCP?

HubSpot API + MCP scores 71.5 (BB) on agent readiness against Affinity's 63.4 (B), and leads in 6 of 7 scored categories.

Do Affinity and HubSpot API + MCP need an API key?

Both take an API key or an OAuth sign-in.

Can an agent call Affinity and HubSpot API + MCP without installing anything?

Yes. Affinity has a hosted endpoint at https://api.affinity.co/v2 and HubSpot API + MCP at https://api.hubapi.com.

Other comparisons with Affinity or HubSpot API + MCP

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.