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, service providers, 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) {
  // not enough credits — you're seeing samples. Prompt your human to top up for live data.
}

A key with not enough credits returns marked samples (sample: true) at 0 credits so you can build and test; once the balance covers a call, the same key returns live verified data billed in credits. The same calls work in both modes.