# NAUT API agent skill

A drop-in skill for AI agents to fetch verified crypto contacts, projects,
investors, service providers, and cross-search from the NAUT API
(https://compass.mesa.so). Call GET /v1/me first: it is free and returns every
endpoint with its path and credit price, so the list below can never be the
thing that goes stale on you.

## Install

1. Download this folder (`SKILL.md`, `compass_fetch.js`, `compass_fetch.py`).
2. Place it in your agent's skills directory, for example `~/.claude/skills/compass-api/`
   for Claude Code, or your framework's equivalent.
3. Set `COMPASS_API_KEY` in your environment. Mint a key at
   https://compass.mesa.so/developer (the full key shows once).

## What's here

- `SKILL.md`: when to use it, the call recipe, and the conversion loops
  (sample -> subscribe, 402 -> top up).
- `compass_fetch.js` / `compass_fetch.py`: one helper function (bearer header,
  JSON parsing, and `sample` / `402` handling).

## Free vs live

A **free** key returns clearly-marked synthetic **samples** (`sample: true`) at 0
credits. Build your integration against them for free. A **paid** key returns
**live** verified data billed in credits. Same calls; swap the key to go live.

Full guide: https://compass.mesa.so/docs/api/for-ai-agents
Machine map: https://compass.mesa.so/llms.txt