How do I install Olaverse?

Olaverse supports both local and remote installation. For local use, install it via pip (uvx) and add the configuration to your AI app. For remote access, add the server URL to your MCP configuration.

Is Olaverse safe to use?

Olaverse was flagged by MCP Marketplace's security scan, scoring 4.6/10 (high risk). It has 5 high or critical findings to review. Review the security report on this page carefully before installing it.

What credentials does Olaverse need?

Olaverse requires the following credentials or environment variables: OLAVERSE_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Olaverse?

Olaverse uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Olaverse MCP Server

by Olaverse Labs

Developer ToolsUse Caution4.6MCP RegistryLocalRemote

Free

Server data from the Official MCP Registry

Document extraction with calibrated confidence, decisions, language ID in 608 languages, diacritics.

About

Document extraction with calibrated confidence, decisions, language ID in 608 languages, diacritics.

Remote endpoints: streamable-http: https://mcp.olaverselab.com/mcp

Security Report

4.6

Use Caution4.6High Risk

This is a legitimate client for the Olaverse API that sends the user's API key only to the Olaverse host and uses permissions that fit its document-processing purpose. The main concern is that in local mode file_path can read any file the user can access and send its contents to the remote API, so a prompt-injected agent could exfiltrate sensitive local files. Lower-severity items are the overridable API URL that receives the bearer key and unbounded whole-file reads. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

4 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your Olaverse API key (console.olaverselab.com)Required

Environment variable: OLAVERSE_API_KEY

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

Olaverse MCP server

Olaverse Lab's API as tools for AI agents: Claude, Cursor and any other MCP client. The models are small, task-specific and strongest on English and African-language text.

Tool	What it does
`extract_document`	A document (text, a JPEG/PNG photo or scan, or a PDF) to JSON shaped like your template, with a calibrated confidence for every field. Long documents are split, extracted in parallel and merged.
`get_extraction_job`	Collects a long-document result that's still running.
`decide`	Typed questions about a message, ticket or record (yes/no, choice, score), with calibrated probabilities. 19 languages.
`detect_language`	The language of a text, among 608 (built African-first, good on very short text).
`restore_diacritics`	Puts back tone marks, accents and Arabic vowel marks in 11 languages, including Yorùbá, Igbo, Hausa and Arabic.
`generate_questions`	Search-style questions a passage answers, in the passage's own language (25 languages).

Set up

You need an Olaverse API key: create one at console.olaverselab.com (new accounts get $1 of free credit). Calls are billed to your key at the usual prices.

The server runs with uv (uvx downloads and runs it).

Claude Code

claude mcp add olaverse --env OLAVERSE_API_KEY=your-key -- uvx olaverse-mcp

Claude Desktop, Cursor and others (the mcpServers block of the client's MCP config file)

{
  "mcpServers": {
    "olaverse": {
      "command": "uvx",
      "args": ["olaverse-mcp"],
      "env": { "OLAVERSE_API_KEY": "your-key" }
    }
  }
}

Hosted (no install). Olaverse also runs this server at https://mcp.olaverselab.com/mcp (streamable HTTP). Send your key with each request as Authorization: Bearer your-key. The hosted server takes documents as text, or as an image or pdf in base64; it doesn't read files or fetch URLs.

Use it

Ask in plain words, and the agent picks the tool:

"Extract the merchant, date, total and line items from ~/Downloads/receipt.jpg."
"Is this customer message asking for a refund, and how urgent is it? «Ẹ jọ̀ọ́, wọ́n ti yọ owó lẹ́ẹ̀mejì…»"
"Which language is 'Mo fẹ́ lọ sí ọjà'?"
"Add the tone marks back: se eranko naa si gbo o?"

Confidence. extract_document returns a confidence for every field. It's calibrated: fields at 0.95 and above are right about 95% of the time on the documents it was built for. Check a threshold on a sample of your own documents before you automate on it.

Settings

Variable	Default
`OLAVERSE_API_KEY`	required	Your API key.
`OLAVERSE_API_URL`	`https://api.olaverselab.com`
`OLAVERSE_JOB_WAIT`	`900`	Seconds a long-document extraction waits before handing back a job id for `get_extraction_job`.

Scanned PDFs (no text layer) aren't read directly: send their pages as JPEG or PNG images.

Licence

Apache-2.0.

mcp-name: io.github.Olaverse-Labs/olaverse-mcp

Reviews

No reviews yet

Be the first to review this server!

4.8

Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.