Skip to content

Quickstart

  1. Sign in to app.mety.ai as an owner or admin of the account.
  2. Open Settings → Agents and click New agent. Give it a name and a title, for example Nana, Chief Sales Officer.
  3. Click New key, choose what the key can do (the default is read, write and feedback) and, optionally, an expiry date. Click Create key.
  4. Copy the key now. Mety shows it once; only a hash is stored. It looks like mety_live_XXXXXXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.

On the Free plan an account may have one active API key; see limits.

Terminal window
export METY_KEY="mety_live_XXXXXXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
curl -s https://api.mety.ai/api/v1/me -H "Authorization: Bearer $METY_KEY"
{
"data": {
"type": "agent",
"agent": { "id": "…", "name": "Nana", "title": "Chief Sales Officer", "status": "active", "…": "…" },
"account": { "id": "…", "name": "NanaNido", "baseCurrency": "EUR", "timezone": "Europe/Madrid", "plan": "free", "…": "…" },
"scopes": ["records:read", "records:write", "feedback:write"],
"key": { "id": "…", "prefix": "XXXXXXXX", "expiresAt": null }
}
}

Now write something. Upserts are safe to re-run:

Terminal window
curl -s -X POST https://api.mety.ai/api/v1/contacts/upsert \
-H "Authorization: Bearer $METY_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: quickstart-1" \
-d '{"matchOn":"email","items":[{"email":"[email protected]","firstName":"Ana","lifecycle":"lead"}]}'
{ "data": [{ "index": 0, "result": "created", "id": "…" }] }

Run it again: the same Idempotency-Key replays the first answer (header Idempotent-Replayed: true). With a new key, the item reports unchanged.

Terminal window
claude mcp add --transport http mety https://api.mety.ai/mcp \
--header "Authorization: Bearer $METY_KEY"

Then ask the model to call whoami and describe_crm. Those two calls give it the agent, the account, the scopes, every field and filter operator, and this account’s pipelines and custom fields.