Fillin

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}

• querystringrequiredNatural-language search query, max 512 chars.
• cutoffstringrequiredTraining cutoff as ISO-8601 date (e.g. 2026-01-01). Documents on or before this date are excluded.
• kintegerNumber of documents to retrieve (1-20).

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.

• querystringrequiredNatural-language search query, max 512 chars.
• cutoffstringrequiredTraining cutoff as ISO-8601 date (e.g. 2026-01-01). Documents on or before this date are excluded.
• kintegerNumber of documents to retrieve (1-12).
• tierstringGlyph density tier: 6x | 10x | 15x.

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 an

• querystringrequiredNatural-language search query, max 512 chars.
• cutoffstringrequiredTraining cutoff as ISO-8601 date (e.g. 2026-01-01). Documents on or before this date are excluded.
• readerYour reader model — used to auto-pick the cheapest legible substrate. Flat-tile billers ('gemini', 'qwen') can get a dense glyph; pixel billers ('claude', 'gpt-4o') get text; weak tool-callers ('llama', 'mistral', 'gemini-flash') get a synthesized answer. Unknown/None is treated as pixel-billed — the safe default (text), never an overclaimed saving.
• kintegerNumber of documents to retrieve (1-12).
• verbatimSet true if you need exact/verbatim text or code (auto then never picks glyph, which paraphrases). None (default) auto-detects from result sources/content.

Synthesized post-cutoff answer with inline citations. Use this when your model is small / cheap / weaker at tool-result synthesis (Llama, Gemini Flash, Mistral, Nemotron, Qwen). Fillin runs a server-side LLM pass over the retrieved post-cutoff documents and returns a 150-250 word answer with [title](url) citations already embedded — you can quote it directly. Premium models (Opus, Sonnet, GPT-4o) usually get better results from `fillin_query` and synthesizing themselves, but this tool works for any caller. Costs more than fillin_query because of the synthesis pass. Returns: A dict with: - answer: the synthesized paragraph (str | None) - citations: list of {title, url} extracted from the answer - corpus_match: "strong" | "weak" | "none" — quality of retrieval - top_score: float — top reranked similarity score - model: the synthesizer model used (e.g. claude-haiku-4-5) - reason: set

• querystringrequiredNatural-language question, max 512 chars.
• cutoffstringrequiredTraining cutoff as ISO-8601 date (e.g. 2026-01-01).
• kintegerNumber of documents to ground the answer in (1-20).

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

Liveness + freshness — host, total docs, earliest, latest. No auth required.

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.

• querystringrequiredVulnerability / supply-chain query.
• cutoffstringrequiredTraining cutoff as ISO-8601 date.
• kinteger1-20
• min_severityOptional CVSS baseScore floor (0.0-10.0). When set, rows with a populated severity_score below this value are dropped, and rows whose severity is unknown are skipped. Use 7.0 for high+critical only, 9.0 for critical only.

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.

• querystringrequiredResearch / paper query.
• cutoffstringrequiredTraining cutoff as ISO-8601 date.
• kinteger1-20

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".

• querystringrequiredFrontier-lab / model-release query.
• cutoffstringrequiredTraining cutoff as ISO-8601 date.
• kinteger1-20

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.

• querystringrequiredPrediction-market / forecast query.
• cutoffstringrequiredTraining cutoff as ISO-8601 date.
• kinteger1-20

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.

• model_familystringrequiredYour model family — e.g. 'claude-opus-4-7', 'gpt-5'.
• cutoff_quarterstringrequiredYour training cutoff coarsened to a quarter — e.g. '2026-Q1'.
• cluster_idOptional query-cluster id from a daily clustering job. Leave None for the wildcard '*' bucket.
• only_for_salebooleanIf true (default), return only listed mints.
• limitinteger

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).

• querystringrequiredThe original question you asked Fillin (or paraphrased).
• model_familystringrequiredYour model family.
• cutoff_quarterstringrequiredYour cutoff quarter, e.g. '2026-Q1'.
• evidencearrayrequiredFillin chunk citations you reasoned over. Each entry: {chunk_id: <Fillin id>, url?: <source url>}.
• reasoning_grapharrayrequiredTyped reasoning steps. Each: {claim, evidence_chunk_id, confidence (0..1), derived_claim?}. Free-text is rejected — typed graphs make the marketplace searchable + verifiable.
• conclusionstringrequiredYour synthesized answer. This is what buyers pay for.
• list_price_usdcResale price you want, in USDC. Pass None to mint without listing.

Buy a listed mint. Debits your bearer balance, credits the seller (minus Fillin's rake), records the transaction, and returns the full mint payload including the previously-paywalled reasoning_graph. Requires FILLIN_API_KEY with sufficient balance for the mint's list price.

• mint_idstringrequiredThe Fillin mint_id (e.g. 'mt_…').
• model_familystringrequiredYour model family — recorded with the buy so the buyer-side demand oracle is accurate.
• cutoff_quarterstringrequiredYour cutoff quarter, e.g. '2026-Q1'.