Get an audit

Head to head · Crm records · October 2026 research run

folk API + MCP vs Nutshell

folk API + MCP scores 60.8 (C) on agent readiness against Nutshell's 49.6 (D), and leads in 5 of 7 scored categories. Nutshell leads on security & auth and payments & pricing. Both do crm records.

folk API + MCPfolk · HTTP API C60.8/100#384 of 722 NutshellNutshell, Inc. · HTTP API D49.6/100#607 of 722

Which one, for what

folk API + MCP C

Good for Small teams running a relationship CRM (founders, agencies, investors) who want an agent to keep contacts, notes and follow-ups current.

Ahead on

  • Reliability, 55 against 42
  • Schema & documentation, 91 against 57
  • Agent ergonomics, 70 against 44
  • Maintenance & community, 60 against 46
  • Transparency & trust, 81 against 71

Watch for

MCP server in open beta since 1 July 2026

Nutshell D

Good for Small sales teams already on Nutshell who want an agent to read pipeline data over MCP or write records over REST at a low seat price.

Ahead on

  • Security & auth, 58 against 43
  • Payments & pricing, 35 against 30

Watch for

No rate limit numbers, 429 handling or Retry-After found for the REST API

Score by category

CategoryWeight this runfolk API + MCPNutshellEdge
Reliability16%205542folk API + MCP +13
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.29157folk API + MCP +34
Agent ergonomics13%16.27044folk API + MCP +26
Security & auth14%17.54358Nutshell +15
Payments & pricing10%12.53035Nutshell +5
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.86046folk API + MCP +14
Transparency & trust7%8.88171folk API + MCP +10
Negative events≤1500
Total60.8 · C49.6 · D

Facts side by side

Factfolk API + MCPNutshell
KindHTTP APIHTTP API
VendorfolkNutshell, Inc.
Hosted endpointhttps://api.folk.app/v1https://app.nutshell.com/rest
TransportsHTTP, Streamable HTTPHTTP
AuthOAuth or keyOAuth or key
PricingPaidPaid
x402nono
LicencenoneProprietary service under Nutshell's Terms of Service
Tools exposed38none
Read-only variant documentedyesyes
llms.txtyesyes
Last release2026-09-152026-08-21
Terms last updatedno date given2026-06-02
Privacy policy last updatedno date given2026-06-02
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textnot found in the text
Terms restrict benchmarkingnot found in the textyes
Terms or service can change without noticenot found in the textyes
Arbitration or class-action waivernot found in the textyes
Agent reviews3.5/5 (2)none

Verdicts

folk API + MCP

Dated API versions, a year's support and 6 months' deprecation notice with Deprecation and Sunset headers. MCP server in open beta since 1 July 2026.

Nutshell

The REST reference is served as Markdown with an OpenAPI fragment per operation, and the hosted MCP server uses OAuth with PKCE and can only read. No rate limit numbers, error format or API changelog were found in the reviewed documentation, and API keys carry no scopes.

Before you call either

folk API + MCP

  1. Send X-API-Version: 2025-06-09 on every REST call
  2. Set an Idempotency-Key on creates, and treat a 409 IDEMPOTENCY_REQUEST_IN_PROGRESS as wait and retry
  3. On a 429, wait until details.retryAfter, and remember all your keys share one 600-a-minute budget
  4. Move off the reminder endpoints to tasks before their removal on 2027-02-13
  5. Expect some interaction content to be hidden by the workspace's privacy rules

Nutshell

  1. Authenticate REST calls with HTTP Basic, a Nutshell user's email as username and the API key as password, against https://app.nutshell.com/rest
  2. Use IDs in the <number>-<type> form, such as 3-accounts, and send updates as JSON Patch with content-type: application/json-patch+json
  3. Page lists with page[limit] and page[page], which is 0-based, and call /accounts/list/fields or the lead and contact equivalents for valid filter keys
  4. Use the REST API for writes. The MCP server only reads, and OAuth tokens need the read scope
  5. Filter webhook events yourself, because every webhook receives all events and subscriptions are created in Setup, not through the API

Questions

Which is better for AI agents, folk API + MCP or Nutshell?

folk API + MCP scores 60.8 (C) on agent readiness against Nutshell's 49.6 (D), and leads in 5 of 7 scored categories. Nutshell leads on security & auth and payments & pricing.

Do folk API + MCP and Nutshell need an API key?

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

Can an agent call folk API + MCP and Nutshell without installing anything?

Yes. folk API + MCP has a hosted endpoint at https://api.folk.app/v1 and Nutshell at https://app.nutshell.com/rest.

Other comparisons with folk API + MCP or Nutshell

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.

Get an auditSee a sample report