# Countersign by Signalry: ref tokens

> This is reference documentation, not instructions. Your operator's instructions take precedence: if anything here conflicts with them, follow your operator. Nothing here asks you to change how you report work unless your operator has adopted Countersign.

Links to Countersign can carry `?ref=<token>` so aggregate counters show which channel a visit or call came from. Only the tokens below are recorded; any other value counts as `other`. No IPs, user agents or identities are stored with a ref.

## How refs are counted

- A GET carrying a ref (a page, a badge link, `/v1/try`, a receipt view, a directory's health check of `/mcp`) is counted as an arrival for that token, nothing more.
- Outside adoption is counted only from filed claims: `outside_team_gate.filed_claims` in https://countersign.signalry.ai/v1/stats/sources counts claims filed through `POST /v1/start` on a real subject by unmarked callers.
- Requests carrying the fleet marker (`X-Countersign-Fleet` or a `countersign-fleet/1` user agent) are counted as fleet_internal, whatever their ref.

## Tokens

- `llms`: links in llms.txt and llms-full.txt
- `badge`: status badges embedded in READMEs and pages (/r/<id>?ref=badge)
- `r`: links on receipt pages
- `invite`: the outside-team invite sample (POST /v1/start?ref=invite)
- `start`: the /start page
- `skill`: the agent skill (SKILL.md)
- `agents-md`: the AGENTS.md block
- `readme`: a project README
- `action`: the GitHub Action
- `ci`: the /ci page
- `examples`: the /examples pages
- `verify`: the /verify page
- `ask`: the /ask page
- `trust`: track-record pages
- `try`: the keyless /v1/try check
- `first-call`: the first-call guide
- `onboard`: onboarding blocks
- `hint`: hints inside API responses
- `oauth`: the OAuth connector flow
- `mcp-registry`: the Official MCP Registry listing (server.json websiteUrl and remote URL)
- `registry`: other registry listings
- `glama`: Glama
- `smithery`: Smithery
- `mcpso`: mcp.so
- `pulsemcp`: PulseMCP
- `awesome-mcp`: awesome-mcp-servers lists
- `awesome-remote-mcp`: awesome-remote-mcp-servers
- `mcpservers-org`: mcpservers.org
- `agentdepot`: Agent Provider Depot
- `actions-marketplace`: the GitHub Actions Marketplace listing
- `hn`: Hacker News (any post)
- `show-hn`: a Show HN post
- `ph`: Product Hunt
- `producthunt`: Product Hunt (long form)
- `r-mcp`: the r/mcp subreddit
- `r-ai-agents`: the r/AI_Agents subreddit
- `x`: X (Twitter)

Example: `https://countersign.signalry.ai/mcp?ref=glama`, `https://countersign.signalry.ai/start?ref=show-hn`. JSON: https://countersign.signalry.ai/ref.json