MessGEODocs
Get an API key

Create a key, first request

You need a MessGEO account with a verified e-mail and either credits or a Prompt Tracking package.

1. Create a key

Open API in your panel, choose Create key, give it a name, tick only the scopes you need, and copy the key. It is shown once.

2. Check the key

curl https://api.messgeo.com/v1/me \
  -H "Authorization: Bearer mgk_xxxxxxxxxx_your_secret"

A successful answer always has data and meta.

{
  "data": {
    "account": { "credits": 120 },
    "key": { "scopes": ["account:read", "tools:run"] }
  },
  "meta": { "request_id": "req_abc123", "next_cursor": null }
}

3. Run a tool

dry_run shows the cost and spends nothing.

curl -X POST https://api.messgeo.com/v1/tools/ai-readiness-score/runs \
  -H "Authorization: Bearer mgk_xxxxxxxxxx_your_secret" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/", "dry_run": true}'

To really run it, send an Idempotency-Key. If your request is repeated with the same key, the first result is returned and no second charge is made.

curl -X POST https://api.messgeo.com/v1/tools/ai-readiness-score/runs \
  -H "Authorization: Bearer mgk_xxxxxxxxxx_your_secret" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-unique-key-001" \
  -d '{"url": "https://example.com/"}'