Ookcite Mcp

by TurtleTech-ehf

1 321 downloads Not rated yet MIT

GitHub Website

About

Validate DOIs against a real citation database, format references in 2900+ CSL styles (APA, IEEE, Chicago, Nature, etc.), and catch hallucinated academic references before they reach your paper or documentation or pitch deck. Manage citation collections, import/export BibTeX, and batch-process references. 29 tools.

Details

License: MIT

Explore

- Validate DOIs to prevent hallucinated references
- Format citations in 2900+ CSL citation styles
- Batch tools for verifying and formatting multiple citations
- Manage bibliography collections with import/export/duplicate check
- Auto-detect and configure popular MCP clients via a single command
- Lightweight stdio MCP server with no local database

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Ookcite Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

One command to install and configure:

npx @turtletech/ookcite-mcp setup

This auto-detects supported MCP clients (Claude Desktop, Claude Code, Cursor,
Codex) and writes the config for you. Grok Build is not covered by setup —
install via the plugin marketplace or the Grok config below. Add an API key
for higher rate limits and collection tools:

npx @turtletech/ookcite-mcp setup --key YOUR_API_KEY

No API key required for basic usage (10 lookups/day).
Sign up for more.

After changing MCP config, restart the client or reload its MCP servers.
Many clients do not hot-reload environment-variable changes for already-running
stdio servers.

npm (recommended):

npm install -g @turtletech/ookcite-mcp

cargo-binstall (fastest, no Node.js):

cargo binstall ookcite-mcp

cargo install (from source):

cargo install ookcite-mcp

Pre-built binaries: Download from
GitHub Releases
for Linux (x86_64, aarch64), macOS (x86_64, aarch64), and Windows.

Set OOKCITE_API_KEY in your shell or Grok env for collection tools (optional for basic lookup/format tools). Trust the plugin when prompted so its MCP server is allowed to start. Manual MCP config (same payload as other clients; Grok also loads project .mcp.json at the repo root):

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

This repository ships that config as .mcp.json plus plugin.jsonfor Grok plugin discovery. After changing MCP config, restart Grok or reload MCP servers.


Optional env (stdio MCP, all clients):

| Variable | Purpose | | -------- | ------- | |OOKCITE_API_KEY| Higher rate limits + collection tools (optional for basic lookup/format) | |OOKCITE_STARTUP_PROBES=1 | Run auth + npm update checks on stderr before accepting MCP connections (default off for faster connect) |

- Prefer batch tools (verify_references, batch_format, batch_add_to_collection,import_bibliography) over many single-citation calls. - Collection mutations requireOOKCITE_API_KEY. Destructive tools (delete_collection, remove_from_collection, unshare_collection`) are
annotated for clients that honor MCP tool hints.
- The server writes diagnostics to stderr only on the MCP path; stdout is
reserved for JSON-RPC.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Give any LLM the ability to validate DOIs, format citations, manage
bibliography collections, and catch hallucinated references. Returns citation
metadata only -- not PDFs or full-text articles. Works with any MCP client:
Grok Build, Claude, Codex, Cursor, Windsurf, OpenCode, Qwen agents, and more.

Quick Start

One command to install and configure:

npx @turtletech/ookcite-mcp setup

npx @turtletech/ookcite-mcp setup --key YOUR_API_KEY

No API key required for basic usage (10 lookups/day).
Sign up for more.

After changing MCP config, restart the client or reload its MCP servers.
Many clients do not hot-reload environment-variable changes for already-running
stdio servers.

Install (Alternative Methods)

npm (recommended):

npm install -g @turtletech/ookcite-mcp

cargo-binstall (fastest, no Node.js):

cargo binstall ookcite-mcp

cargo install (from source):

cargo install ookcite-mcp

Pre-built binaries: Download from
GitHub Releases
for Linux (x86_64, aarch64), macOS (x86_64, aarch64), and Windows.

Configure

If you used setup, you're done. Otherwise, add to your MCP client config:

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

With an API key:

{
  "mcpServers": {
    "ookcite": {
      "command": "npx",
      "args": ["-y", "@turtletech/ookcite-mcp"],
      "env": {
        "OOKCITE_API_KEY": "your_key_here"
      }
    }
  }
}

If you installed globally (npm install -g or cargo install), you can use
"command": "ookcite-mcp" directly instead of npx.

Common config file locations:

| Client | Config file |
| ---------------------- | ----------------------------------------------------------------- |
| Grok Build | Plugin install (below) or ~/.grok/config.toml / project .mcp.json |
| Claude Desktop (Linux) | ~/.config/Claude/claude_desktop_config.json |
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Code | .mcp.json (project) or ~/.claude/settings.json (global) |
| Cursor | Settings > MCP Servers |
| Codex | ~/.codex/config.toml |

Grok Build

Recommended: install from the xAI plugin marketplace
once published (/marketplace in Grok Build, search for ookcite). The
marketplace entry clones this repo at a pinned commit and loads the bundled
.mcp.json + plugin.json.

From this repo (local / PR testing):

```bash
grok plugin install /path/to/ookcite-mcp

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Quick Start

Install (Alternative Methods)

Configure

Grok Build

More like this

Sequential Thinking

Aws Kb Retrieval Server

Time

Memory