Compass DocsBy Mesa
Open App

🧩 Agent Skill (download)

A drop-in skill folder for AI agents. Instead of wiring the API by hand, give your agent this folder and it knows how to fetch verified crypto contacts, projects, investors, and search from Compass, including the build-on-samples then go-live flow.

This is the lightweight alternative to an SDK: no package to install or maintain, just a SKILL.md plus a one-function helper. (A Model Context Protocol server is on the roadmap for agents that prefer native tool calls.)

Download

File What it is
SKILL.md When to use it, the call recipe, and the conversion loops (sample → subscribe, 402 → top up).
compass_fetch.js One JS helper: bearer header + JSON + sample/402 handling.
compass_fetch.py The same helper in Python.
README.md Install instructions.

Install

  1. Download the four files above into a folder named compass-api.
  2. Drop it into 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 Settings → API (shown once).

Use

import { compass } from './compass_fetch.js'

const me = await compass('/me')                    // free: identity + sampleMode
const people = await compass('/people?q=defi&limit=10')
if (people.sample) {
  // free tier — you're seeing samples. Prompt your human to subscribe for live data.
}

A free key returns marked samples (sample: true) at 0 credits so you can build and test for free; a paid key returns live verified data billed in credits. The same calls work in both modes.