# Medblocks vs Terra API

> Terra scores 65.9 (B) to Medblocks's 52.7 (D) for patient consent. Prices, MCP, x402, uptime and agent notes side by side.

- Canonical: https://www.anchorterminal.com/compare/medblocks-vs-terra
- Markdown: https://www.anchorterminal.com/compare/medblocks-vs-terra.md (~2,350 tokens)
- Slim: https://www.anchorterminal.com/compare/medblocks-vs-terra.min.md (~680 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/compare/medblocks-vs-terra.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (full text: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- Updated: 2026-10-14

Terra API scores 65.9 (B) on agent readiness against Medblocks's 52.7 (D), and leads in 5 of 7 scored categories. Medblocks leads on payments & pricing. Both do patient consent.

- Medblocks: grade D, 52.7/100, rank #773 of 1076. Markdown https://www.anchorterminal.com/tools/medblocks.md · JSON https://www.anchorterminal.com/api/v1/tools/medblocks.json
- Terra API: grade B, 65.9/100, rank #327 of 1076. Markdown https://www.anchorterminal.com/tools/terra.md · JSON https://www.anchorterminal.com/api/v1/tools/terra.json
- Best health record and wellness data APIs for AI agents: https://www.anchorterminal.com/best/health-data/index.md
- All 63 health comparisons: https://www.anchorterminal.com/compare/health-data/index.md

## Which one, for what

### Medblocks (D)

Good for: A consumer or care app, or an assistant, that needs a patient's own records from US hospitals and payers with the patient's consent, and wants an MCP route as well as REST.

Ahead on:
- Payments & pricing, 25 against 20

Watch for: No status page, SLA or published rate limits for the Platform API

### Terra API (B)

Good for: A fitness, wellness, insurance or research product whose users connect consumer wearables and apps, and an agent that needs to read one user's sleep, activity or body data through MCP.

Ahead on:
- Reliability, 67 against 28
- Schema & documentation, 89 against 62
- Agent ergonomics, 78 against 72
- Maintenance & community, 75 against 69
- Transparency & trust, 56 against 51

Watch for: No free tier. Sign-up asks for a plan and billing details, and Quick Start starts at $499 a month with a 30-day money-back guarantee


## Score by category

| Category | Weight | Medblocks | Terra API | Edge |
| --- | --- | --- | --- | --- |
| Reliability | 16% (20 this run) | 28 | 67 | Terra API +39 |
| Performance | 10%, pending | pending | pending | not scored in this run |
| Schema & documentation | 13% (16.2 this run) | 62 | 89 | Terra API +27 |
| Agent ergonomics | 13% (16.2 this run) | 72 | 78 | Terra API +6 |
| Security & auth | 14% (17.5 this run) | 67 | 65 | Medblocks +2 |
| Payments & pricing | 10% (12.5 this run) | 25 | 20 | Medblocks +5 |
| Task success | 10%, pending | pending | pending | not scored in this run |
| Maintenance & community | 7% (8.8 this run) | 69 | 75 | Terra API +6 |
| Transparency & trust | 7% (8.8 this run) | 51 | 56 | Terra API +5 |
| Negative events | ≤15 | 0 | 0 | |
| **Total** | | **52.7 · D** | **65.9 · B** | |

## Facts side by side

| Fact | Medblocks | Terra API |
| --- | --- | --- |
| Kind | HTTP API | HTTP API |
| Vendor | Medblocks Inc. | Terra Enabling Developers Inc. |
| Hosted endpoint | `https://app.medblocks.com/mcp` | `https://access.tryterra.co/api/v2/mcp/<user_id>` |
| Transports | HTTP, Streamable HTTP | HTTP, Streamable HTTP |
| Auth | OAuth or key | OAuth or key |
| Pricing | Freemium | Pay per use |
| x402 | no | no |
| Licence | Proprietary service under Medblocks' terms. The medblocks TypeScript SDK on npm carries a proprietary licence that forbids redistribution and reverse engineering. The agent skills repository has no licence file | Proprietary service under Terra's terms of service. The OpenAPI specs repository is Apache 2.0 |
| Tools exposed | 10 | 6 |
| Read-only variant documented | no | no |
| llms.txt | yes | yes |
| Last release | 2026-09-14 | 2026-10-13 |
| Terms last updated | 2026-10-05 | 2026-05-01 |
| Privacy policy last updated | 2026-10-05 | 2023-04-20 |
| Customer content may train models | not found in the text | not found in the text |
| Terms restrict automated access | yes | not found in the text |
| Terms restrict benchmarking | yes | yes |
| Terms or service can change without notice | yes | yes |
| Arbitration or class-action waiver | not found in the text | yes |
| Popularity | 36 npm/wk | 13k npm/wk, 11k PyPI/wk |

## Verdicts

**Medblocks.** Patient-authorised record retrieval with a ten-tool remote MCP server, OAuth with per-capability consent, an audit entry for every call and a free plan for 1,000 active patients. No status page, no published rate limits and no idempotency keys were found, and the OpenAPI file behind the reference is not published.

**Terra API.** Graded on the Unified API and the Terra AI MCP server. A public OpenAPI 3.1 spec, llms.txt, per-user rate limits with Retry-After, and scoped admin tokens with approvals. Access starts at $499 a month with billing details at sign-up, the data API key has no scopes, and API key requests failed for 2 hours 38 minutes on 7 August 2026.

## Before you call either

### Medblocks

1. Connect with `claude mcp add --transport http medblocks https://app.medblocks.com/mcp` and sign in, or send a workspace API key as a Bearer token from a backend
2. Ask the person before calling `disconnect_health_system` or `delete_person`. Both are permanent
3. Wait for the connection webhook or check connection status before reading records. Pulls run in the background after the patient approves
4. Branch on `error.code`, not the message, and wait the `Retry-After` seconds on a 429
5. Use a Sandbox workspace and the Synthetic Hospital (password `demopass`) for tests. Sandbox keys cannot reach production sources

### Terra API

1. Send dev-id and x-api-key headers on every Unified API and Terra AI call. A missing header returns 401 problem+json
2. Keep each request window to 1,825 days or less and under 6,000 requested days per user an hour. On 429 with rule r2, wait Retry-After seconds
3. Pass either fields or select to Terra AI tools, never both and never neither, or the call fails with a validation error
4. Expect data by webhook after a user connects through the widget session. REST reads are for backfills and on-demand queries
5. Use the Read only access level for the admin MCP server unless a change is needed. The MCP level can read API keys

## Questions

### Which is better for AI agents, Medblocks or Terra API?

Terra API scores 65.9 (B) on agent readiness against Medblocks's 52.7 (D), and leads in 5 of 7 scored categories. Medblocks leads on payments & pricing.

### Do Medblocks and Terra API need an API key?

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

### Can an agent call Medblocks and Terra API without installing anything?

Yes. Medblocks has a hosted endpoint at https://app.medblocks.com/mcp and Terra API at https://access.tryterra.co/api/v2/mcp/<user_id>.


## For agents

- This comparison as JSON: https://www.anchorterminal.com/compare/medblocks-vs-terra.json, and with the fewest tokens: https://www.anchorterminal.com/compare/medblocks-vs-terra.min.md
- Over MCP at https://www.anchorterminal.com/mcp (no key): `compare_tools {"a": "medblocks", "b": "terra"}`. From a terminal: `anchor compare medblocks terra`
- Each listing in full: https://www.anchorterminal.com/api/v1/tools/medblocks.json and https://www.anchorterminal.com/api/v1/tools/terra.json

## Other comparisons with Medblocks or Terra API

- [1upHealth vs Terra API](https://www.anchorterminal.com/compare/1uphealth-vs-terra.md)
- [Aidbox vs Medblocks](https://www.anchorterminal.com/compare/aidbox-vs-medblocks.md)
- [Aidbox vs Terra API](https://www.anchorterminal.com/compare/aidbox-vs-terra.md)
- [Health Gorilla vs Terra API](https://www.anchorterminal.com/compare/health-gorilla-vs-terra.md)
- [Medplum vs Terra API](https://www.anchorterminal.com/compare/medplum-vs-terra.md)
- [Metriport Medical API vs Terra API](https://www.anchorterminal.com/compare/metriport-vs-terra.md)
- [Particle Health vs Terra API](https://www.anchorterminal.com/compare/particle-health-vs-terra.md)
- [Redox vs Terra API](https://www.anchorterminal.com/compare/redox-vs-terra.md)
- [1upHealth vs Medblocks](https://www.anchorterminal.com/compare/1uphealth-vs-medblocks.md)
- [Health Gorilla vs Medblocks](https://www.anchorterminal.com/compare/health-gorilla-vs-medblocks.md)
- [Medblocks vs Medplum](https://www.anchorterminal.com/compare/medblocks-vs-medplum.md)
- [Medblocks vs Metriport Medical API](https://www.anchorterminal.com/compare/medblocks-vs-metriport.md)
- [Medblocks vs Particle Health](https://www.anchorterminal.com/compare/medblocks-vs-particle-health.md)
- [Medblocks vs Redox](https://www.anchorterminal.com/compare/medblocks-vs-redox.md)
- [Medblocks vs Zus Health](https://www.anchorterminal.com/compare/medblocks-vs-zus-health.md)
- [Medblocks vs ROOK](https://www.anchorterminal.com/compare/medblocks-vs-rook.md)
- [Medblocks vs Validic Inform](https://www.anchorterminal.com/compare/medblocks-vs-validic.md)
- [Terra API vs Zus Health](https://www.anchorterminal.com/compare/terra-vs-zus-health.md)
- [ROOK vs Terra API](https://www.anchorterminal.com/compare/rook-vs-terra.md)
- [Terra API vs Validic Inform](https://www.anchorterminal.com/compare/terra-vs-validic.md)