{
  "name": "conceptio",
  "version": "1.0.0",
  "description": "Conceptio — the open-access document retrieval layer for AI agents. A large live corpus of books, papers, standards, and case law; every source open access or public domain; agent-ready provenance (sha256, publisher, authority score) on every result.",
  "docs": "https://www.conceptio.app/docs",
  "repository": "https://github.com/0x923041-dotcom/conceptio-cli",
  "license": "open-access",
  "transport": {
    "type": "stdio",
    "protocol": "2024-11-05",
    "command": "conceptio",
    "args": ["mcp"]
  },
  "install": {
    "one_line": "pip install conceptio-search",
    "mcp_servers_json": {
      "mcpServers": {
        "conceptio": { "command": "conceptio", "args": ["mcp"] }
      }
    },
    "frameworks": {
      "claude_desktop": "Add the mcpServers block to claude_desktop_config.json, then restart Claude Desktop.",
      "cursor": "Add the mcpServers block to .cursor/mcp.json in your project, or via Cursor Settings > MCP > Add.",
      "windsurf": "Add the mcpServers block to .windsurf/mcp_config.json.",
      "opencode": "Add the mcpServers block to opencode.json, or run: opencode mcp add conceptio -- npx -y conceptio mcp",
      "any_mcp_client": "Point any MCP client at the stdio command `conceptio mcp` after `pip install conceptio-search`."
    }
  },
  "rate_limits": {
    "policy": "Sliding window with request pacing. Every authenticated request (signed-in session, API key `X-Api-Key` `ckey_live_*`, or license key `X-License-Key` via `conceptio auth <key>`) counts against the account tier budget. Pro tier is limited to 60 req/min with a 2,000 weekly search quota (resets Mondays 00:00 UTC). Enterprise is 300 req/min. Anonymous traffic (no credential) is limited per IP to 60 req/min.",
    "tiers": {
      "pro": { "requests_per_minute": 60, "weekly_search_quota": 2000, "note": "Pro tier budget with 2,000 searches/week" },
      "enterprise": { "requests_per_minute": 300, "note": "Enterprise-wide uncapped searching" },
      "anonymous": { "requests_per_minute": 60, "note": "per-IP floor for non-account traffic" }
    }
  },
  "tools": [
    {
      "name": "conceptio_search",
      "description": "Search the live open-access corpus of papers, technical standards (NIST, OWASP, CISA, IETF), textbooks, and legal databases (EUR-Lex, HUDOC, US case law). Query supports directives like 'source:nist zero trust'. Every result carries a machine-readable proof bundle: sha256 content hash, publisher, authority score, license, retrieved timestamp, citation strings.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Search keywords or directives (e.g. 'source:nist zero trust')" },
          "limit": { "type": "integer", "description": "Number of results (1-20)", "default": 10 },
          "category": { "type": "string", "description": "Optional category filter: 'Science & Medicine', 'Economics & Finance', 'Computer Science & Tech', 'Social Sciences & Humanities', 'Arts & Culture', 'Law & Regulation'" }
        },
        "required": ["query"]
      }
    },
    {
      "name": "conceptio_resolve",
      "description": "Resolve a known identifier straight to its document(s): RFC number ('RFC 2119'), DOI ('doi:10.1145/3290605.3300333'), arXiv ID ('2604.08499'), PubMed ID ('PMID 41961061'), PubMed Central ID ('PMC10601397'), NIST/FIPS designation ('NIST FIPS 199'), W3C spec shortname ('w3c_digital-credentials'), EU legal shortname or CELEX number (GDPR, AI Act, 2016/679), UK act, or US legal citation / docket ('410 U.S. 113', '20-5364'). Unrecognized identifiers fall back to a text search. Results carry proof bundles + related documents.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": { "type": "string", "description": "The identifier to resolve (e.g. 'RFC 2119', 'doi:10.x/y', 'PMC10601397', '410 U.S. 113')" },
          "limit": { "type": "integer", "description": "Max results (1-50)", "default": 10 }
        },
        "required": ["id"]
      }
    },
    {
      "name": "conceptio_download_pdf",
      "description": "Download the original open-access PDF of a paper, standard, or book to a local file path. Accepts a Conceptio document ID (from conceptio_search/conceptio_resolve) or a direct PDF URL.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "doc_id_or_url": { "type": "string", "description": "Conceptio document ID (digits) or direct PDF URL" },
          "output_path": { "type": "string", "description": "Local destination file path (e.g. 'workspace/paper.pdf')" }
        },
        "required": ["doc_id_or_url", "output_path"]
      }
    },
    {
      "name": "conceptio_get_document",
      "description": "Fetch the complete document record for an ID: metadata, license, access level, origin URL, direct PDF URL, related documents, and the machine-readable proof bundle (sha256 content hash, publisher, authority score, retrieved timestamp, citation strings). When full text is available it is included.",
      "inputSchema": {
        "type": "object",
        "properties": { "doc_id": { "type": "integer", "description": "Conceptio document ID" } },
        "required": ["doc_id"]
      }
    },
    {
      "name": "conceptio_get_citation",
      "description": "Get an academic citation for a document in 11 formats: BibTeX, APA, MLA, Chicago, IEEE, Harvard, RIS, Bluebook, OSCOLA, ISO 690, ANSI/NISO Z39.29.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "doc_id": { "type": "integer", "description": "Conceptio document ID" },
          "format": { "type": "string", "enum": ["bibtex", "apa", "mla", "chicago", "ieee", "harvard", "ris", "bluebook", "oscola", "iso690", "ansiz39"], "default": "bibtex" }
        },
        "required": ["doc_id"]
      }
    },
    {
      "name": "conceptio_watch_create",
      "description": "Start watching a document, structured identifier, or query for changes. Snapshot a sha256 fingerprint of the currently-resolved document set so a later conceptio_watch_check can detect new/changed documents. Target types: 'doc' (numeric Conceptio ID), 'identifier' (RFC/DOI/PMID/regulation/statute/case/patent/procurement/ticker/ISO/OGC/Khronos/...), 'query' (free text).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "target_type": { "type": "string", "enum": ["doc", "identifier", "query"], "description": "What to watch: a document id, a structured identifier, or a free-text query", "default": "identifier" },
          "target": { "type": "string", "description": "The thing to watch: doc id, identifier (e.g. '40 CFR 1502', 'ticker TSLA', 'RFC 9110'), or search query" },
          "label": { "type": "string", "description": "Optional human label" },
          "limit": { "type": "integer", "description": "Max docs in the fingerprint snapshot", "default": 20 }
        },
        "required": ["target"]
      }
    },
    {
      "name": "conceptio_watch_check",
      "description": "Recompute a watch's fingerprint and report whether anything changed since the last snapshot: added/removed doc ids, a human detail line, previous vs current fingerprint. Pull-driven (no daemon) — call periodically to detect new editions, superseding standards, or updated regulations.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "watch_id": { "type": "integer", "description": "The watch id from conceptio_watch_create" }
        },
        "required": ["watch_id"]
      }
    },
    {
      "name": "conceptio_watch_list",
      "description": "List all watches with their fingerprints, change counts, and last check summaries.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    },
    {
      "name": "conceptio_section_search",
      "description": "Search a phrase across a specific section kind (risk_factors, contracts, financials, ...) in every document carrying extracted full text. Section-attributed hits per document. This is how an agent answers 'which 10-Ks' risk factors mention X?'.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "q": { "type": "string", "description": "Phrase to search for within the section kind" },   "kind": {
    "type": "string",
    "default": "risk_factors",
    "description": "Section kind: risk_factors, business, management/mda, contracts, exhibits, financials, litigation, controls, balance_sheet, income_statement, cash_flows, equity, footnotes"
   },
          "source": { "type": "string", "description": "Restrict to one source (e.g. sec_edgar)" },
          "max_docs": { "type": "integer", "default": 20, "description": "Max documents to scan (most-recent full-text rows)" }
        },
        "required": ["q"]
      }
    },
    {
      "name": "conceptio_section_kinds",
      "description": "List the supported section kinds for conceptio_section_search with a short description of each.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      }
    }
  ],
  "capabilities": [
    "Full-text search over a large live open-access corpus with source/language/category filters",
    "Identifier resolution: RFC, DOI, arXiv, PMID, PMCID, NIST/FIPS, W3C, EU legal (CELEX/shortnames), UK acts, US case citations + dockets, SEC accession/CIK/ticker, patents, procurement/contract IDs, ISO/OGC/Khronos standards",
    "Change detection: watch a document, identifier, or query and detect added/changed documents (snapshot/diff, pull-driven)",
    "Document retrieval with provenance: sha256 content hash, publisher, authority score, license, retrieved timestamp",
    "Related documents (topical) in the same round-trip",
    "Section-level structure, in-document search, AND cross-document section search (e.g. risk factors across 10-Ks)",
    "Citations in 11 formats",
    "PDF download of open-access originals",
    "Machine-readable proof bundles on every search + resolve result (agent-verifiable answers)"
  ],
  "example_prompts": [
    "Search for NIST SP 800-207 and summarize its zero trust architecture.",
    "Resolve RFC 2119 and give me the direct PDF.",
    "Search for 'source:eurlex GDPR' and cite the result in Bluebook format.",
    "Resolve 410 U.S. 113 and give me the case's full metadata plus related documents.",
    "Watch the EU AI Act and tell me if anything new is indexed.",
    "Resolve ticker TSLA and show me its SEC filings.",
    "Create a watch on 'ticker TSLA' and check it daily for new filings."
  ]
}
