Head to head · FHIR servers · October 2026 research run
Metriport Medical API vs Terra API
Terra API scores 65.9 (B) on agent readiness against Metriport Medical API's 50.1 (D), and leads in 6 of 7 scored categories. Both do fhir servers.
Best health record and wellness data APIs for AI agents · All 63 health comparisons
Which one, for what
Best for US care providers and digital health companies that need a patient's network records as FHIR with webhooks.
Also in its favour
- Open source
Watch for
Every API key has full access, including destructive operations, with no scopes
Best 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 45
- Schema & documentation, 89 against 65
- Agent ergonomics, 78 against 70
- Security & auth, 65 against 41
- Payments & pricing, 20 against 5
Also in its favour
- A hosted endpoint, with nothing to install
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 this run | Metriport Medical API | Terra API | Edge |
|---|---|---|---|---|
| Reliability | 16%20 | 45 | 67 | Terra API +22 |
| Performance | 10%pending | pending | pending | not scored in this run |
| Schema & documentation | 13%16.2 | 65 | 89 | Terra API +24 |
| Agent ergonomics | 13%16.2 | 70 | 78 | Terra API +8 |
| Security & auth | 14%17.5 | 41 | 65 | Terra API +24 |
| Payments & pricing | 10%12.5 | 5 | 20 | Terra API +15 |
| Task success | 10%pending | pending | pending | not scored in this run |
| Maintenance & community | 7%8.8 | 74 | 75 | Terra API +1 |
| Transparency & trust | 7%8.8 | 56 | 56 | even |
| Negative events | ≤15 | 0 | 0 | |
| Total | D 50.1/100 | B 65.9/100 |
Facts side by side
| Fact | Metriport Medical API | Terra API |
|---|---|---|
| Kind | HTTP API | HTTP API |
| Vendor | Metriport Inc. | Terra Enabling Developers Inc. |
| Hosted endpoint | no (local only) | https://access.tryterra.co/api/v2/mcp/<user_id> |
| Transports | HTTP | HTTP, Streamable HTTP |
| Auth | API key | OAuth or key |
| Pricing | Paid | Pay per use |
| x402 | no | no |
| Licence | Proprietary hosted service under Metriport's terms of use. The source in metriport/metriport is AGPLv3, with an enterprise directory under its own licence, and the @metriport/api-sdk package on npm is MIT | Proprietary service under Terra's terms of service. The OpenAPI specs repository is Apache 2.0 |
| Tools exposed | none | 6 |
| Read-only variant documented | no | no |
| llms.txt | yes | yes |
| Last release | 2026-09-28 | 2026-10-13 |
| Terms last updated | 2024-01-01 | 2026-05-01 |
| Privacy policy last updated | 2023-02-21 | 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 | yes | yes |
| Popularity | 793 stars, 28k npm/wk | 13k npm/wk, 11k PyPI/wk |
Verdicts
Metriport Medical API
One network query pulls a patient's records from HIEs, pharmacies and labs and returns deduplicated FHIR, with per-operation rate limits, RFC 7807 errors and AGPLv3 source. Each API key has full access with no scopes, there are no public prices, and the sandbox opens only after Metriport approves the account.
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
Metriport Medical API
- Check the
errorsarray after Start Network Query. It returns 2XX even when some sources fail - Wait for
network-query.*webhooks or poll Get Network Query Status before reading consolidated data, which is cached from the last query - Send the resource's
eTaginIf-Matchon updates to avoid overwriting newer data - Keep patient creates under 15 a minute and network queries under 20 a minute per source
- In sandbox, create patients whose first name matches a pre-defined persona to get example records
Terra API
- Send dev-id and x-api-key headers on every Unified API and Terra AI call. A missing header returns 401 problem+json
- 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
- Pass either fields or select to Terra AI tools, never both and never neither, or the call fails with a validation error
- Expect data by webhook after a user connects through the widget session. REST reads are for backfills and on-demand queries
- 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, Metriport Medical API or Terra API?
Terra API scores 65.9 (B) on agent readiness against Metriport Medical API's 50.1 (D), and leads in 6 of 7 scored categories.
Do Metriport Medical API and Terra API need an API key?
Metriport Medical API needs an API key. Terra API takes an API key or an OAuth sign-in.
Can an agent call Metriport Medical API and Terra API without installing anything?
No hosted endpoint is listed for Metriport Medical API. Terra API has a hosted endpoint at https://access.tryterra.co/api/v2/mcp/<user_id>.
Are Metriport Medical API and Terra API open source?
Metriport Medical API is open source (Proprietary hosted service under Metriport's terms of use. The source in metriport/metriport is AGPLv3, with an enterprise directory under its own licence, and the @metriport/api-sdk package on npm is MIT). No open-source release is listed for Terra API.
Other comparisons with Metriport Medical API or Terra API
- 1upHealth vs Terra API
- Aidbox vs Metriport Medical API
- Aidbox vs Terra API
- Health Gorilla vs Terra API
- Medplum vs Metriport Medical API
- Medplum vs Terra API
- Metriport Medical API vs ROOK
- Particle Health vs Terra API
- Redox vs Terra API
- 1upHealth vs Metriport Medical API
- Health Gorilla vs Metriport Medical API
- Medblocks vs Metriport Medical API
- Metriport Medical API vs Particle Health
- Metriport Medical API vs Redox
- Metriport Medical API vs Zus Health
- Medblocks vs Terra API
- Metriport Medical API vs Validic Inform
- Terra API vs Zus Health
- ROOK vs Terra API
- Terra API vs Validic Inform
Machine-readable
- This page as Markdown
/compare/metriport-vs-terra.md· slim.min.md· JSON.json(or sendAccept: text/markdown) - Each listing in full
/api/v1/tools/metriport.json·/api/v1/tools/terra.json - From a terminal
anchor compare metriport terra(the CLI) - Over MCP
compare_tools {"a": "metriport", "b": "terra"}at/mcp, no key