The developer surface is assembling the current API contract, Realness playground sample, proof-state gate, and public source packet. API examples and score fields stay withheld until the measured payload resolves.
Developer contract read pending.
No fallback API rows, quiet-zero Realness sample, proof-state claim, or fabricated public post is shown while this loads.
Measurement, not advice.Realness is aggregate coordination measurement, never a named accusation.Public X authors only from provider expansions; no profile dossiers or PII exports.Public post excerpts stay bounded by provider/source receipts.
Advanced receiptsSupporting evidence, provider, and ingestion proof stays available.6 receipts
Post evidence
Curated posts declare their provenance.
Show post source and evidence labels; pin top_posts_sort.
Curated post evidence states for snapshot top posts
State
Source example
UI label
Client meaning
fixture
privacy_safe_fixture
fixture evidence
Synthetic dev/test evidence shape. Not live social text.
event: snapshot · heartbeatserver-sent events with unchanged-frame suppression
dashboard tables that want live measured rows
Snapshot socket
WS
/v1/snapshot/leaderboard/ws
{"event":"snapshot|heartbeat"}persistent socket with unchanged-frame suppression
automated systems and long-lived tape subscribers
Signal feed
GET
/v1/bot-feed/signals
typed envelopesbounded query
decision systems consuming measurement events
ssewebsocketauth
const events = new EventSource(
"/api/snapshot/leaderboard/stream?limit=25&interval=5",
);
events.addEventListener("snapshot", ({ data }) => {
const frame = JSON.parse(data);
const rows = frame.leaderboard ?? [];
for (const row of rows) {
const ad = row.core_kpi_values?.attention_density ?? row.attention_density ?? null;
console.log(row.ticker, ad, row.anomaly_band);
}
});
function streamKeyProtocol(userScopedKey) {
const bytes = new TextEncoder().encode(userScopedKey);
let binary = "";
for (const byte of bytes) binary += String.fromCharCode(byte);
return "ad-key." + btoa(binary)
.replace(/\+/g, "-")
.replace(/\//g, "_")
.replace(/=+$/, "");
}
const wsUrl = new URL("wss://api.attentiondensity.com/v1/snapshot/leaderboard/ws");
wsUrl.searchParams.set("limit", "25");
wsUrl.searchParams.set("interval", "5");
const userScopedKey = await getUserScopedStreamKey();
const socket = new WebSocket(wsUrl, [
"attention-density.snapshot.v1",
streamKeyProtocol(userScopedKey),
]);
EventSource cannot send custom headers, so the browser uses the same-origin proxy with the key held server-side. Browser WebSocket auth uses the Sec-WebSocket-Protocol handshake instead of URL credentials.
Model Context Protocol
The methodology is itself a tool.
With repository access, launch the source-pinned server. Its 17 tools keep each value with its receipt.
Attention MCP tool catalog (17 tools)
Tool
What it returns
attention_leaderboard
Tickers ranked by Attention Density (social activity per $1B market cap).
attention_ticker
Attention Density detail for one ticker.
attention_bot_feed
Structured attention signals (ranking input, never an execution trigger).
attention_signals
Recent signal events with the shared core KPI receipt and cursor contract.
attention_ticker_signals
Ticker-scoped signal history with the shared core KPI receipt.
attention_buckets
Market-cap bucket cohorts ranked through the shared core KPI contract.
attention_themes
Per-theme attention overview plus top ticker cohorts with core KPI receipts.
attention_watchlist
A saved watchlist ranked through the same core KPI contract as the tape.
attention_core_kpis
The published core KPI catalog for resolving compact core_kpis receipts.
sso_contract
The published Signal Ontology (every metric's formula + inputs) + fingerprint and JSON Schema.
attention_snapshot_leaderboard
Live Attention Density ranking snapshot.
attention_as_of
Point-in-time archive replay over the tape with a no-lookahead receipt.
attention_state_changes
Bounded state-change push ledger from the local tape archive.
attention_live_diagnostics
Tape health measurable today: snapshot/cycle/ticker counts, turnover, attention regime.
scorecard_summary
The citable validation snapshot: per-signal verdict/IC/significance/power + FDR survivors.
reputation_scorecard
The citable author-graph validation: does credibility predict, hold, and persist.
attention_attestation
The single trust receipt binding SSO, scorecard, reputation, and archive integrity fingerprints.
launchcall
# Requires access to the private source repository and configured Git credentials:
uvx --from 'attention-density[mcp] @ git+https://github.com/FlyingMobula5/AttentionDensity@41aa1b1659cde4aac09ac4857d8c7aecf1edacd4' attention-density-mcp
# Alternatives:
# pipx run --spec 'attention-density[mcp] @ git+https://github.com/FlyingMobula5/AttentionDensity@41aa1b1659cde4aac09ac4857d8c7aecf1edacd4' attention-density-mcp
# python -m pip install '.[mcp]' && python -m attention_density.mcp.server
# First call — Fetch the published Signal Ontology before consuming any KPI value.
{
"tool": "sso_contract",
"arguments": {}
}
No public package or source release exists. Repository access is required. The Git command is pinned to 41aa1b1659cd.
Endpoints
KPI API surface.
Start with the five API paths that define, rank, and deliver the KPI spine.
Primary KPI API paths
Surface
Method
Path
Payload
Access
KPI catalog
GET
/v1/core-kpis
five field definitions
public
API scope
GET
/v1/api-scope
payload boundary
public
Leaderboard
GET
/v1/snapshot/leaderboard
ranked KPI rows
public current snapshot
Ticker
GET
/v1/snapshot/ticker/{ticker}
single-name KPI packet
public current + replay
Realness API
GET
/v1/realness/{ticker}
measurement + withheld veto gate
public · verdict gated
Signals
GET
/v1/bot-feed/signals
typed event envelopes
MarketSchema key required
Full route inventory3 groups · 24 routes
01Snapshot tapecurrent and historical leaderboard payloads
Current and ?as_of ticker reads are public. Keyed feeds return a typed 401; MarketSchema owns keys and pricing.
Accounts open soon — measurements are free to read.
PUBLICHTTP 200
currenttickerpublic
replay?as_ofpublic
/health, /docs, /redoc, and /openapi.json stay public for readiness and integration checks.
401jsonhub
curl -sS "$AD_API/v1/bot-feed/signals?limit=1"
{
"error_contract": "api-error-envelope-v1",
"error": "unauthorized",
"message": "missing or invalid API key",
"status_code": 401
}
# Keys and pricing live at the hub. Accounts open soon.
Errors
Failures use one public envelope.
api-error-envelope-v1 covers validation, access, and runtime failures.
