Quickstart
1. Create an agent and a key
Section titled “1. Create an agent and a key”- Sign in to app.mety.ai as an owner or admin of the account.
- Open Settings → Agents and click New agent. Give it a name and a title, for example
Nana,Chief Sales Officer. - Click New key, choose what the key can do (the default is read, write and feedback) and, optionally, an expiry date. Click Create key.
- 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.
2. First REST call
Section titled “2. First REST call”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:
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.
3. Connect an MCP client
Section titled “3. Connect an MCP client”claude mcp add --transport http mety https://api.mety.ai/mcp \ --header "Authorization: Bearer $METY_KEY"{ "mcpServers": { "mety": { "type": "http", "url": "https://api.mety.ai/mcp", "headers": { "Authorization": "Bearer mety_live_XXXXXXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" } } }}No key needed. Add a custom connector with the URL https://api.mety.ai/mcp and press Connect. Mety opens
in the browser; tick the accounts to connect and click Allow. See
connecting clients.
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.
- Core concepts: the data model in five minutes.
- REST conventions: envelopes, pagination, idempotency, dry run, errors.
- MCP tools: the full tool catalogue.
- Recipe: import a Gmail mailbox.