# Compass API agent skill

A drop-in skill for AI agents to fetch verified crypto contacts, projects,
investors, and cross-search from the Compass API (https://compass.mesa.so).

## Install

1. Download this folder (`SKILL.md`, `compass_fetch.js`, `compass_fetch.py`).
2. Place it in your agent's skills directory — e.g. `~/.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 > Settings > API (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