# Terra API (slim)

> Terra's Unified API collects activity, sleep, body and nutrition data from 500+ wearables and health apps, normalises it into one schema and sends it by webhook or REST. An MCP server, Terra AI, lets agents read a connected user's data.

- Full: https://www.anchorterminal.com/tools/terra.md (~7,050 tokens) · this version ~1,680 tokens · JSON https://www.anchorterminal.com/tools/terra.json · canonical https://www.anchorterminal.com/tools/terra
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-14

**B · 65.9/100 · rank #327 of 1076 · #2 in Health records & wellness data · not agent-ready · confidence medium**


Assessment: 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.

## Facts

- Kind: HTTP API · vendor: Terra Enabling Developers Inc. · category: Health records & wellness data · legal entity: Terra Enabling Developers Inc. · provenance 69/100
- Endpoint: `https://access.tryterra.co/api/v2/mcp/<user_id>` (HTTP, Streamable HTTP)
- Auth: OAuth or key · pricing: Pay per use · x402: no · licence: Proprietary service under Terra's terms of service. The OpenAPI specs repository is Apache 2.0
- Probe metrics: not measured yet (probes haven't run)
- APIs: Unified API v2 (OpenAPI 3.1, 55 operations, version 2026.10.08.1), Streaming API (AsyncAPI), Teams API, Vantage API, admin API (101 operations), all in github.com/tryterra/openapi
- MCP servers: Terra AI at https://access.tryterra.co/api/v2/mcp/<user_id>, six read tools, dev-id and x-api-key headers. Admin server at https://access.tryterra.co/api/v3/admin/mcp, OAuth with client ID metadata documents, no dynamic client registration
- Credentials: Unified API and Terra AI take dev-id plus one x-api-key per environment (testing, staging, production). Admin API and admin MCP take personal access tokens with 26 scopes, 7 to 90 day lifetimes and optional environment limits
- Rate limits: Per user, 1,825 days per request window and 6,000 requested days per UTC hour bucket on data-read endpoints. 429 carries X-Terra-RateLimit-Rule and Retry-After for the hourly rule
- Errors: application/problem+json with code and detail, for example 401 `unauthorized` and 403 `scope_missing`. Terra AI documents guaranteed error strings for transport and tool failures
- Environments: Testing and staging capped at 50 users each, production unlimited
- Pricing: Quick Start from $499 a month with 100,000 credits. Extra credits $0.005 to 1,000,000 and $0.003 above. 200 credits per active authentication a month, first 400 events per authentication free then 0.5 credits each. Model runs 1 credit ($0.01). Enterprise custom with BAA and SLAs
- SDKs: terra-python 1.1.0 and terra-api 2.1.0 on npm (2 October 2025), Terra CLI @tryterra/cli 0.20.0 (9 October 2026), mobile SDKs for iOS, Android, React Native and Flutter. The legacy JavaScript package no longer receives updates
- Status: status.tryterra.co on Instatus, groups for 78 data providers and Terra infrastructure, with incident history and RSS
- Certifications: SOC 2 Type II, HIPAA and GDPR claimed on tryterra.co. The Vanta trust centre is drawn by script and was not read
- Prices: Quick Start plan, 100,000 credits included $499 per month (plan); Credit beyond the monthly allowance (100,001 to 1,000,000) $0.005 per credit

- Scores: Reliability 67, Performance pending, Schema & documentation 89, Agent ergonomics 78, Security & auth 65, Payments & pricing 20, Task success pending, Maintenance & community 75, Transparency & trust 56 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines and scored on the Unified API and Terra AI. · Schema & documentation, OpenAPI 3.1 specs in tryterra/openapi for the Unified, admin, Teams, Vantage and widget APIs, plus AsyncAPI for streaming (25). · Agent ergonomics, Terra AI has six tools, each taking an explicit fields or select list, which keeps responses small. · Security & auth, The data API key is one x-api-key per environment with no scopes, rotatable through the admin API. · Payments & pricing, Read with the hosted rubric. · Maintenance & community, The OpenAPI repository was republished on 13 October 2026 and @tryterra/cli 0.20.0 shipped on 9 October (30). · Transparency & trust, Closed service with public terms dated 1 May 2026 and Apache 2.0 specs (17 of 30).
- Sources: 24, open questions: 6, both in the full twin
- Capabilities: health.wearables, health.consent, health.fhir
- JSON: https://www.anchorterminal.com/api/v1/tools/terra.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/terra.svg` or a link to https://www.anchorterminal.com/tools/terra from a page on tryterra.co or one of its subdomains, or the README of github.com/tryterra/openapi, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

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

## Connect

```bash
claude mcp add --transport http terra-ai https://access.tryterra.co/api/v2/mcp/<user_id> --header "dev-id: <YOUR_DEV_ID>" --header "x-api-key: <YOUR_API_KEY>"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/terra

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| ROOK | C | 54.9 | health.wearables, health.consent, health.fhir | https://www.anchorterminal.com/tools/rook.min.md |
| Aidbox | B | 64.2 | health.fhir, health.consent | https://www.anchorterminal.com/tools/aidbox.min.md |
| Health Gorilla | C | 59.3 | health.fhir, health.consent | https://www.anchorterminal.com/tools/health-gorilla.min.md |
| Validic Inform | C | 57.9 | health.wearables, health.consent | https://www.anchorterminal.com/tools/validic.min.md |
| Zus Health | C | 56.6 | health.fhir, health.consent | https://www.anchorterminal.com/tools/zus-health.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)