# Conceptio Search MCP server

> Search over 1 million open-access papers, standards, and case law to download PDFs, resolve identifiers, and manage citations via an AI agent.

- Repository: https://github.com/0x923041-dotcom/conceptio-cli
- Page: https://hostedmcp.org/servers/0x923041-dotcom/conceptio-cli
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.3.14

## Install

### Claude Code

```sh
claude mcp add --env 'CONCEPTIO_API_KEY=<YOUR_CONCEPTIO_API_KEY>' conceptio-cli -- uvx conceptio-search
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "conceptio-cli": {
      "command": "uvx",
      "args": [
        "conceptio-search"
      ],
      "env": {
        "CONCEPTIO_API_KEY": "<YOUR_CONCEPTIO_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "conceptio-cli": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "conceptio-search"
      ],
      "env": {
        "CONCEPTIO_API_KEY": "<YOUR_CONCEPTIO_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"conceptio-cli","type":"stdio","command":"uvx","args":["conceptio-search"],"env":{"CONCEPTIO_API_KEY":"<YOUR_CONCEPTIO_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "conceptio-cli": {
      "command": "uvx",
      "args": [
        "conceptio-search"
      ],
      "env": {
        "CONCEPTIO_API_KEY": "<YOUR_CONCEPTIO_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add conceptio-cli --env 'CONCEPTIO_API_KEY=<YOUR_CONCEPTIO_API_KEY>' -- uvx conceptio-search
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.conceptio-cli]
command = "uvx"
args = ["conceptio-search"]

[mcp_servers.conceptio-cli.env]
CONCEPTIO_API_KEY = "<YOUR_CONCEPTIO_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'CONCEPTIO_API_KEY=<YOUR_CONCEPTIO_API_KEY>' conceptio-cli uvx -- conceptio-search
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "conceptio-cli": {
      "command": "uvx",
      "args": [
        "conceptio-search"
      ],
      "env": {
        "CONCEPTIO_API_KEY": "<YOUR_CONCEPTIO_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CONCEPTIO_API_KEY` | yes | yes | Conceptio API key (Free, Dev, Pro or Enterprise) from your profile at https://www.conceptio.app. Required because an MCP client cannot run the CLI's interactive auth. |

## Tools (9)

- `conceptio_search`: Search the open-access archive — papers, technical standards (NIST, OWASP, CISA), textbooks, and legal sources (EUR-Lex, HUDOC) with license-aware access. Requires an API key: run `conceptio auth` once first. Query supports directives like 'source:nist zero trust'. (read-only)
- `conceptio_resolve`: Resolve a known identifier straight to its document(s) in the archive: an RFC number ('RFC 2119'), a DOI ('doi:10.1109/access.2020.2986772'), an arXiv ID ('2604.08499'), a PubMed ID ('PMID 41961061'), a PubMed Central ID ('PMC10601397'), a NIST/FIPS designation ('NIST FIPS 199'), a W3C spec shortname ('w3c_digital-credentials'), or a US legal citation / docket ('347 U.S. 483', '20-5364'). Unrecognized identifiers fall back to a text search. Use this when an agent has a concrete citation/reference it wants to locate precisely. (read-only)
- `conceptio_download_pdf`: 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) or a direct PDF URL.
- `conceptio_get_citation`: Get an academic citation for a document in BibTeX, APA, MLA, or Chicago format. (read-only)
- `conceptio_search_batch`: Run multiple independent searches in one call. Default: queue 1–50 for bounded background execution and return an opaque job handle (poll it with the public API or `conceptio search-job`). Set sync:true to run 1–10 immediately and return all results in one response — each fresh subquery uses one search credit either way.
- `conceptio_connectors_send`: Save one document to Zotero or open a metadata-only Obsidian handoff. Server-side ownership, connector trial, and failure semantics apply.
- `conceptio_connectors_send_all`: Bulk-save selected documents to Zotero. Pro, institutional, or licensed access is required; no free trial path.
- `conceptio_get_document`: Fetch complete metadata (title, author, source, license, description, direct PDF URL) for a document ID. (read-only)
- `conceptio_graph_walk`: Walk the reference graph from one seed source_id — the compliance walk: what that document cites (direction='out'), what cites it (direction='in'), or both. Optional kind filter selects cites/updates. Returns nodes with a distance from the seed and canonical edges carrying their relation kinds; dangling targets appear as claimed nodes. Metadata-only: spends no credits. Use when an agent needs provenance — what cites this regulation two hops out — instead of a keyword search. (read-only)

## FAQ

### What kind of documents can I search for?

You can search over 1 million open-access documents including papers, standards, textbooks, and case law from over 500 sources.

### How do I authenticate the Conceptio Search CLI?

You need to sign in at conceptio.app to get an API key and then use the command `conceptio auth ckey_live_...` to save it to your local config.

### Can I use this with Claude Desktop or Cursor?

Yes, you can add it as an MCP server in your Claude Desktop or Cursor configuration files using the `conceptio mcp` command.

### What citation formats are supported?

The server supports 11 formats: BibTeX, APA, MLA, Chicago, IEEE, Harvard, RIS, Bluebook, OSCOLA, ISO 690, and ANSI Z39.
