Countersign · Quickstart · Examples · CI · Verify a receipt · Markdown

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