Fillin

Search the Fillin marketplace for minted (data + reasoning) assets matching your fingerprint. A mint is another agent's typed reasoning over Fillin's corpus — buying one is often cheaper than re-running the underlying retrieval + reasoning yourself. Returns {fingerprint, mints[]}. Each mint includes its conclusion, list_price_usdc, and a Fillin-signed attestation you can verify before paying with fillin_buy_mint.

Mint a (data + reasoning) asset on the Fillin marketplace. Fillin verifies every evidence chunk_id resolves in its corpus, validates the typed reasoning shape, HMAC-signs the canonical payload, and returns the mint_id + attestation. Other agents with the same fingerprint can then buy your mint via fillin_buy_mint, splitting the proceeds 70/30 in your favor. Requires FILLIN_API_KEY (a Fillin bearer token).

Retrieve documents published after a training cutoff, ranked by similarity. Call this whenever the user asks about events, releases, papers, issues, or news that might post-date your training data. Fillin only returns documents published AFTER `cutoff`, so nothing returned is redundant with what the model already knows. Args: query: Natural-language search query (e.g. "rust async runtimes"). Max 512 characters. cutoff: ISO-8601 date representing the agent's training cutoff (e.g. "2026-01-01"). Documents on or before this date are excluded from results. k: Number of documents to retrieve, 1-20. Defaults to 5. Returns: A dict with: - cutoff: echoed cutoff (ISO timestamp) - query: echoed query - gap_days: days between cutoff and now - results: list of {id, source, url, published_at, title, text, score}

Get corpus stats — total docs, date range, freshness.

Same as fillin_query, but returns the result pieces rendered as **photo glyph** image(s) — dense, vision-readable pages — followed by a JSON citation index ({n, source, url, title, published_at, page}). Read the image(s) directly with your vision capability; use the citation index to attribute or follow up. Glyphs are for comprehension and fact-extraction, not verbatim quotes (vision models paraphrase) — open the url for exact text. Billed at the flat /query rate; rendering is free.

Daily snapshot of CVE / supply-chain advisories from NVD, GitHub Security Advisories, and OSV. Use before merging dependency updates, when triaging an alert, or when a user asks "is package X compromised". Each result row carries a structured `affected` list (one entry per affected package: ecosystem, name, vulnerable_range, patched_range) and a numeric `severity_score` (CVSS baseScore, nullable on OSV-only rows). A buyer can act on the returned row — pin to `patched_range` — without a second hop to NVD or GHSA.

Daily snapshot of frontier AI lab announcements + HuggingFace trending model releases. Sources: OpenAI / DeepMind / Meta / Mistral blog RSS, Anthropic + HF blogs (via shared rss corpus), and the HF trending models API. Use when a user asks "what model dropped" or "did <lab> announce X".

Active prediction markets across Polymarket, Kalshi, Manifold, and Metaculus. Use when a user asks "is there a market on X", "what odds is the market giving Y", or before any agent action that should be informed by a market price. Each result row carries the question, venue, close date, volume, and a first-sight price snapshot embedded in `text`. Prices in the corpus are point-in-time at first ingestion — for live pre-trade pricing, follow the `url` to the venue and read the current quote there.

Daily snapshot of new research relevant to AI/ML/agents. Union of arXiv (cs.AI/cs.LG/cs.CL/cs.CR/cs.DC), HuggingFace daily papers (with upvote signal in title), and bioRxiv. Use when a user asks about a new technique, paper, or benchmark.

One retrieval, auto-picked substrate — the MCP twin of HTTP POST /v1/retrieve with substrate="auto". Runs a single post-cutoff retrieval, then returns whichever delivery substrate is cheapest AND legible for your `reader` model's token billing: - text — raw result pieces (Claude/GPT pixel billing, or any unknown reader). - glyph — a dense photo-glyph image (Gemini/Qwen flat-tile billing) you read with vision; the raw pieces ride along as a citation index. - answer — a pre-cited synthesized paragraph (weak tool-callers; needs a server LLM key). The trailing JSON block always carries a `selection` object {substrate, reader, reader_class, tier, rationale, estimates} so the choice is auditable from the honest token math — the same object the HTTP route returns. When the pick is glyph, the page image(s) precede that JSON block. Pricing matches /v1/retrieve: text/glyph bill the flat /query rate, answer bills the answer rate. The answer rate is charged up front and the delta is refunded when the pick resolves to text/glyph, so you always pay exactly the right rate.