Skip to Content
UsageMapDocs

For AI agents

Let Claude Code, Codex or any coding agent integrate UsageMap for you, using our SKILL.md and llms.txt.

Give your agent the skill

SKILL.md is an instruction file for coding agents, in the open Agent Skills format. It walks the agent through the whole integration: the tracker in your framework, wallet events, OpenTelemetry for your API, registering your contracts, and then a test that checks the data arrived. It stops and asks you for anything that needs your wallet.

Install it as a project skill:

mkdir -p .claude/skills/usagemap-instrument
curl -fsSL https://docs.usagemap.dev/SKILL.md -o .claude/skills/usagemap-instrument/SKILL.md

Then ask: "Add UsageMap analytics to this app."

Your agent needs your site key (from the website's Snippet tab) and, for APIs, an ingest token. The site key is public. Put the token in an environment variable or your secret store, never in the code or the chat.

Docs for language models

FileWhat's in it
/llms.txtAn index of every page in these docs, with a one-line summary
/llms-full.txtAll pages in one Markdown file, ready to paste into a context window
Any page as MarkdownEvery page has a Markdown version. Use the Copy Markdown button at the top of a page.

Ask your numbers from your assistant (coming)

Not live yet

A read-only MCP server is built and will run at https://app.usagemap.dev/mcp. It isn't deployed yet; this section will say so when it is.

With it, an assistant such as Claude can answer questions like "how many verified visitors did we have last month?" from your own project's numbers. You connect it with a share key (scfa_pub_…, project → Sharing), which can only read your metrics document and your signed snapshots. It can never change anything.

On this page