Skip to content

Get API access.

Two routes, and which one you want depends on what is calling. Both start from a Plantactic account.

Self-serve

Connect it to Claude

Add Plantactic as a connector in Claude and approve it. Approving is what provisions you: if the account signing in has no API access yet, it is created and linked at that moment. There is nothing to request and nobody to wait for.

  1. 1. Create a Plantactic account if you do not have one.
  2. 2. In Claude, open Settings → Connectors → Add custom connector and give it https://mcp.plantactic.com/mcp. Leave the OAuth client fields empty — the server advertises its own registration endpoint and enrols Claude for you.
  3. 3. Sign in, read what you are approving, and connect.

The connector guide covers the tools, the permission model, and what the connector cannot see.

On request

A REST key of your own

For your own client — a script, a service, a scheduled job — you want a ptx_test_ or ptx_live_ key. These are issued by Plantactic against your account rather than minted from a form, so this route involves us: mail support@plantactic.com from the address on your account and say which mode you need.

Self-service key issuance does not exist yet.

Which credential you end up with

live

Connecting through Claude

An OAuth credential scoped to your account — its access tokens carry the ptx_oauth_ prefix — and it is issued live. There is no sandbox variant of a connected session. Disconnecting revokes it on the next request, not after a cache expires.

test

A ptx_test_ key

Works in an account that is never billed and cannot reach live data. It is a REST credential only — test mode is not reachable through the connector.

A REST key is shown once, at issue time; after that it is stored hashed and cannot be retrieved. The connector's credential is never shown at all — nothing outside it needs the value. The two prefixes are never interchangeable, and neither is a dataset created under one.

Your first call

If you took the REST route, this is the call that proves the key works. Connected through Claude instead? You never see that credential — ask Claude to list your datasets, and the same call happens on your behalf.

listing what the account can see 
curl https://ptx-api.plantactic.com/v1/datasets \
  -H "Authorization: Bearer ptx_live_4e91c8..."

# -> the datasets this account can see

From there, the quickstart walks a dataset from empty to a metric grid in three calls.