Head to head · Spend transactions · October 2026 research run

Mercury API vs Ramp

Mercury API scores 63.8 (B) on agent readiness against Ramp's 57.3 (C), and leads in 4 of 7 scored categories. Ramp leads on schema & documentation, maintenance & community and transparency & trust. Both do spend transactions.

Which one, for what

Mercury API B

Good for A company that banks with Mercury and wants an agent to read balances and transactions, set notes and categories, upload receipts, issue virtual cards with spend limits and queue payments for human approval.

Ahead on

  • Reliability, 59 against 30
  • Payments & pricing, 30 against 25

Also in its favour

  • No incidents deducted, where Ramp loses 3 points for them

Watch for

No rate limits with numbers and no 429 handling were found in the reviewed documentation

Ramp C

Good for A finance team already on Ramp that wants an agent to read transactions, upload receipts, code and split expenses, issue funds with limits, create bills and work with purchase orders and procurement requests.

Ahead on

  • Schema & documentation, 86 against 72
  • Maintenance & community, 74 against 64
  • Transparency & trust, 70 against 63

Watch for

No public status page was found. status.ramp.com doesn't resolve, and no status link appears in the docs, help centre or trust centre pages read

Score by category

CategoryWeight this runMercury APIRampEdge
Reliability16%205930Mercury API +29
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.27286Ramp +14
Agent ergonomics13%16.26866Mercury API +2
Security & auth14%17.58279Mercury API +3
Payments & pricing10%12.53025Mercury API +5
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.86474Ramp +10
Transparency & trust7%8.86370Ramp +7
Negative events≤150-3
Total63.8 · B57.3 · C

Facts side by side

FactMercury APIRamp
KindHTTP APIHTTP API
VendorMercury Technologies, Inc.Ramp Business Corporation
Hosted endpointhttps://api.mercury.com/api/v1https://api.ramp.com
TransportsHTTPHTTP
AuthOAuth or keyOAuth
PricingFreemiumFreemium
x402nono
LicenceProprietary service under Mercury's Terms of Use. The Mercury CLI on GitHub is Apache-2.0Proprietary service under the Ramp Platform Agreement and the API Agreement. The ramp-cli repository is MIT
Tools exposed35none
Read-only variant documentedyesno
llms.txtyesyes
Last release2026-08-122026-10-07
Terms last updatedno date givencouldn't be read
Privacy policy last updatedno date givencouldn't be read
Customer content may train modelsnot found in the textcouldn't be read
Terms restrict automated accessyescouldn't be read
Terms restrict benchmarkingyescouldn't be read
Terms or service can change without noticenot found in the textcouldn't be read
Arbitration or class-action waiveryescouldn't be read
Popularitynone53 stars

Verdicts

Mercury API

Custom tokens take per-endpoint scopes, write tokens need an IP allowlist, and payments can be queued for approval in the dashboard through POST /account/{accountId}/request-send-money. No rate limits, error catalogue or SLA were found in the reviewed documentation, the changelog carries no dates, and the MCP server is beta.

Ramp

OAuth 2.0 scopes split read from write across about 40 resources, a 260-operation OpenAPI spec is public, and an audit log endpoint records actions by user and agent. No public status page was found, 89 operations are marked beta, the API Agreement allows changes without notice, and idempotency keys cover only eight write operations.

Before you call either

Mercury API

  1. Ask for a Custom token with only the scopes the task needs. Scopes can't be edited later, and a token unused for 45 days is deleted.
  2. Without a fixed IP address, send payments through POST /account/{accountId}/request-send-money. Direct sends through POST /account/{accountId}/transactions need an allowlisted IP.
  3. Send a stored idempotencyKey with every payment. The same recipient, account, amount and method within 24 hours returns 400 even with a new key.
  4. Set limit on list calls. GET /transactions returns up to 1,000 rows by default.
  5. Test against https://api-sandbox.mercury.com/api/v1/ with a sandbox token. Webhooks aren't available in the sandbox.

Ramp

  1. Send scope on the client credentials token request. Without it Ramp issues a token with no scopes and every resource call fails with 403
  2. Follow the full URL in next to page. page_size defaults to 20 and stops at 100, and the cursor is opaque
  3. Stay under 200 requests in any 10 seconds per source IP and back off 1, 2 then 4 seconds on 429. No Retry-After header is documented
  4. Don't use synced_after or from_created_at to find changed records. Bills and transactions have no updated-at filter, so subscribe to webhooks
  5. Send X-Idempotency-Key when creating funds or procurement requests. Elsewhere a retried POST can create a duplicate, so read back before retrying

Questions

Which is better for AI agents, Mercury API or Ramp?

Mercury API scores 63.8 (B) on agent readiness against Ramp's 57.3 (C), and leads in 4 of 7 scored categories. Ramp leads on schema & documentation, maintenance & community and transparency & trust.

Do Mercury API and Ramp need an API key?

Mercury API takes an API key or an OAuth sign-in. Ramp uses an OAuth sign-in.

Can an agent call Mercury API and Ramp without installing anything?

Yes. Mercury API has a hosted endpoint at https://api.mercury.com/api/v1 and Ramp at https://api.ramp.com.

Other comparisons with Mercury API or Ramp

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.