§ Reference · Documentation · v1.0
Documentation
Provenio exposes its research index as a set of typed tools over the open Model Context Protocol (MCP) standard. This page is the canonical developer reference; the latest tool list is always served live at /api/mcp.
Quick start
- Pick a client — Claude Desktop, ChatGPT (MCP enabled), Cursor, or any MCP-compliant assistant.
- Add the connector:
https://provenio.art/api/mcp - Optionally set
Authorization: Bearer <license_key>for Pro / Institutional rate limits. - Issue a natural-language query — Provenio returns evidence with citations and named gaps.
Tool catalogue
27 typed tools in 7 categories — see the live tools/list response or the published OpenAPI 3.1 spec.
- Discovery — search_artists, search_artworks, search_events, search_institutions, search_transactions, search_movements, get_artist, get_artwork, get_event, get_institution, get_movement, get_polity, get_concept
- Provenance & relations — get_provenance_chain, get_career_trajectory, get_relations, get_exhibitions_for_artist, get_concept_relations, get_recent_works
- Market analytics — analyze_market_trends, search_priced_transactions
- External federation — lookup_met_museum, lookup_europeana, lookup_wikidata_art, byok_external_query (Pro+ only)
Rate limits
| Tier | Monthly cap | Identifier |
|---|---|---|
| Free | 200 queries | hashed IP (daily salt) |
| Pro | 10,000 queries | SHA-256 license key |
| Institutional | unlimited | DPA-bound |
Response envelope contract
Every successful tool response includes:
coverage_gaps— fields the index could not populate, named explicitlysuggested_next_tools— agentic-friendly progressive disclosuredata_density— stub / partial / full classification per entity
BYOK setup
For querying your own private archive endpoints — see /byok-setup. The byok_external_query tool enforces an HTTPS-only, SSRF-hardened allowlist (RFC1918 incl. 172.16/12, IPv6 ULA, loopback, and decimal/octal encoded IPs are all refused).
Status & SLAs
- Service status: status.provenio.art
- P95 latency target: under 3 seconds (internal queries)
- Solo tier email response: 48 hours
- Institutional incident response: 4 hours
Smithery listing
The canonical Smithery slug is mildo-ai/provenio — smithery.ai/server/mildo-ai/provenio