# OokCite [Health: Active]

**Category:** 🔬 Research  
**Repository:** https://github.com/TurtleTech-ehf/ookcite-mcp  
**GitHub Stars:** 2  
**npm Downloads (last month):** 707  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ookcite

## Description
Catch fabricated citations: verify DOIs/ISBNs and format them in 2900+ CSL styles.

## Tools
Capabilities this server exposes over MCP:

- **validate_doi** — Check if a DOI exists (anti-hallucination)
- **lookup_isbn** — Look up a book by ISBN
- **reverse_lookup** — Find a paper from messy citation text; returns original query, confidence, and title
- **batch_resolve** — Resolve many citation strings in one request (max 50)
- **enhanced_search** — Corpus search with author / category / citation facets
- **health_check** — Check API availability and health
- **format_citation** — Format a DOI in any of 2900+ CSL styles (no API key for a single citation)
- **verify_references** — Batch-check DOIs, and any bibliographic claim passed with them
- **batch_format** — Format multiple citations at once
- **search_styles** — Find CSL style IDs by name
- **list_styles** — Page through the full CSL style list
- **group_cite** — Generate grouped in-text markers (e.g. [1-3])
- **usage** — Plan in effect plus daily (and monthly) lookups remaining
- **orcid_search** — Find ORCID profiles by name, affiliation, or ORCID ID
- **orcid_profile** — Fetch one ORCID profile by ID
- **ingest_orcid** — Index an ORCID profile's publications so they are searchable
- **list_collections** — List saved citation collections
- **add_to_collection** — Add a citation (by DOI or free-text)
- **batch_add_to_collection** — Add multiple citations at once
- **import_bibliography** — Import BibTeX, RIS, or a pasted plaintext list
- **export_collection** — Export collection as BibTeX or CSL text
- **search_collection** — Search within a collection; returns `entry_id` per match
- **check_duplicates** — Check for duplicates; returns `entry_id` for matches
- **delete_collection** — Delete a collection
- **update_collection** — Update name, description, or style
- **remove_from_collection** — Remove an entry by `entry_id`, bare DOI, or `doi:10.x/y
- **update_entry_metadata** — Correct a saved entry's title, authors, year, DOI, …
- **merge_entries** — Merge two entries of one collection into one
- **update_tags** — Set tags on a collection
- **reorder_collection** — Reorder entries
- **share_collection** — Create a shareable link
- **unshare_collection** — Revoke sharing
- **view_shared** — View a shared collection by token
- **merge_collections** — Merge multiple collections
- **batch_move_entries** — Move entries between collections
- **generate_citation_keys** — Better BibTeX-style keys for a list of DOIs
- **expand_journal** — Expand a journal abbreviation to its full name
- **normalize_bibliography** — Re-render BibTeX or RIS as canonical BibTeX

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "ookcite": {
    "command": "npx",
    "args": ["-y","@turtletech/ookcite-mcp"]
  }
}
```

## Documentation

## What OokCite MCP server does

OokCite MCP server connects MCP-compatible clients to citation lookup and bibliography management services. Its tools work with DOI, ISBN, free-text citation, ORCID, CSL style, and collection data. The service returns citation metadata rather than PDFs or full-text articles, so it fits reference validation and bibliography workflows rather than literature retrieval.

The server supports both anonymous and authenticated use. Basic usage includes a daily limit of 20 lookups, while an API key or signed-in account provides higher rate limits and access to collection features.

## How it works

For local clients, the server communicates through standard input and output. It can be launched with the npm package, a Cargo installation, or a pre-built release binary. Remote clients connect to `https://ookcite-api.turtletech.us/mcp` using Streamable HTTP and OAuth sign-in; the remote endpoint does not accept pasted API keys.

Citation tools can validate a DOI, find a book from an ISBN, identify a paper from imperfect citation text, or resolve up to 50 citation strings in one request. Search supports author, category, and citation facets. Formatting tools accept DOI-based citations and CSL style identifiers, including grouped in-text markers and batch formatting.

## Setup and configuration

The quickest installation is:

```bash
npx @turtletech/ookcite-mcp setup
```

The setup command can detect supported MCP clients and write their configuration. `setup --connect` opens the TurtleTech dashboard, creates or activates a Free plan, and stores credentials through the platform credential store. On headless systems, use `setup --connect --device`. Existing deployments can provide `--key YOUR_API_KEY`, or configure `OOKCITE_API_KEY` directly.

Credential retrieval can instead use `OOKCITE_API_KEY_COMMAND` or `OOKCITE_API_KEY_FILE`. The command-based method has a timeout controlled by `OOKCITE_API_KEY_TIMEOUT`, which defaults to 10 seconds. `OOKCITE_API` can override the default API base URL. After changing configuration, restart the MCP client or reload its servers.

## Tools and capabilities

OokCite MCP server exposes tools for:

- DOI, ISBN, citation-text, and batch reference resolution
- DOI and bibliographic-claim verification
- CSL style search, listing, and citation formatting
- Grouped citation markers and usage-limit checks
- ORCID profile search, retrieval, and publication ingestion
- Collection creation workflows, including import, export, search, duplicate checks, tagging, ordering, metadata updates, merging, and deletion

`import_bibliography` accepts BibTeX, RIS, or pasted numbered and blank-line citation lists. Anonymous small plaintext imports can contain up to eight items and return BibTeX without saving a collection. Authenticated collection operations can save resolved entries and export them as BibTeX or CSL text.

## Limitations and notes

The service supplies metadata only and never fetches PDFs or full-text articles. Anonymous access is limited, and collection tools require authentication. A single citation can be formatted without an API key, while broader limits and saved collection operations require an account or key.

`OOKCITE_MCP_READ_ONLY=1` disables collection mutations, and `OOKCITE_MCP_ALLOW_MUTATE=0` denies mutations. These settings are useful for review or CI environments. The `batch_resolve` operation accepts at most 50 citation strings per request.

_Full upstream README: https://allmcps.com/mcp/ookcite/readme_