← drillable.com

Drillable — Documentation

A reference gateway (remote MCP server): source-cited answers across dozens of curated corpora, claims checked against named sources, and an honest "no record" instead of a guess. Built for AI agents and the people who rely on them.

Setup

Drillable is authless — no API key, no account. Connect to https://mcp.drillable.com (streamable HTTP):

• Claude.ai (web) / Claude Desktop: Settings → Connectors → Add custom connector → URL https://mcp.drillable.com → no authentication.
• Claude Code: claude mcp add --transport http drillable https://mcp.drillable.com
• Any MCP client: point it at https://mcp.drillable.com (streamable HTTP, no auth).

Tools

The server lists five tools. Each corpus's deeper verbs are reached through describe (the map) and call (the dispatch), so the listing stays small no matter how many corpora mount.

• lookup — Look up a concept. Define a term/concept from a domain's glossary (e.g. lookup "crop factor"). For records/entities, use search.
• search — Search the corpora. Find records by query across the mounted corpora; pass domain to target one.
• verify — Verify claims against sources. Check a claim (or a list of claims) against the corpora; returns a typed per-claim verdict (verified / corrected / abstained) with the drilled value and source.
• describe — Describe a domain's tools. No args → every mounted domain with its verbs grouped by rung. With domain → that domain's full verb list and input schemas. Use it whenever the spine (lookup/search/verify) is too shallow.
• call — Call a domain verb. Invoke a deeper verb discovered via describe (e.g. cocktail / reachable_cocktails, chemistry / compute_molar_mass).

Example prompts

• "What are the ingredients of a classic Negroni?" — a cited recipe, verified against the IBA spec.
• "What are the dose facts for supplemental magnesium — common forms and the upper limit?" — NIH-cited dose facts, kept as reference (not medical advice).
• "Verify this: a Negroni is equal parts gin, Campari, and sweet vermouth." — grounded against the cited record, with a flag if anything differs.
• "What can you tell me about the flibbertigibbet effect?" — an honest "no record," not a fabricated definition.

Troubleshooting & good to know

• An honest "no record" is the intended behavior, not an error. Drillable abstains rather than guess when something is outside its corpora — and logs the miss as a demand signal for what to add next.
• If a query misses, try a more specific entity or concept, or target a single domain (e.g. ask within "cocktail" or "chemistry"). Call describe to see what a domain actually holds.
• "Verified" is a point-in-time check, not a warranty — it means a record was checked against its named source at the time marked.
• Rate limits are enforced (the service is free); agents are welcome through the MCP endpoint within them.
• Keep sensitive identifiers out of queries (PHI, account numbers, client names). Unanswered queries are logged as the public demand signal; the corpus answers reference questions (codes, rules, criteria) and never needs them. See the privacy & terms.
• Coverage is finite and growing — outside the mounted corpora, it abstains by design.