Gemina MCP Server

This repository is the discovery, install, and examples surface for Gemina's MCP server. The server itself is hosted at https://api.gemina.co/api/v1/mcp/ — there is no daemon to run locally. Point…

Remote serverstreamable-http

What is the Gemina MCP Server?

Gemina | MCP Server is an MCP project maintained in the tommyil/gemina-mcp repository. The maintainer describes its purpose as “This repository is the discovery, install, and examples surface for Gemina's MCP server. The server itself is hosted at https://api.gemina.co/api/v1/mcp/ — there is no daemon…”. Read the project documentation for the complete scope.

Hosted connection

The maintainer’s configuration uses https://api.gemina.co/api/v1/mcp/. Check the project’s account and authentication instructions when adding the endpoint to your client.

Configuration values

The example declares GEMINA_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
files_create_uploadReserve a pre-signed PUT slot. Returns file_id, the upload URL, the headers to echo on the PUT, and a next_tool_call recipe — tag_file by default…
tag_fileRun the FileTag pipeline on an uploaded slot: metadata, six filename patterns, and a short-lived enriched-file URL.
tag_urlFetch a public HTTPS URL server-side and tag it — the bytes never pass through the model context.
extract_documentRun one or more extraction types on an uploaded slot (from files_create_upload): invoice_headers, invoice_line_items, custom_template, ocr (plain text; runs…
get_extraction_resultPoll an asynchronous extraction by meta.correlationId.
list_extractionsList past extractions, newest first, with filters and pagination.
get_extractionFetch one extraction by id, including the full extracted data.
get_documentFetch one document by id, including all of its extractions.
add_document_extractionsRun more extraction types on a document Gemina already stores (by id) — no re-upload; paid per extraction. Two modes: wait for the values (default), or…
submit_extraction_feedbackSend verified/corrected field values back — the extraction-quality feedback loop.
query_documentsSearch your indexed documents: structured filters, semantic similarity, or hybrid (best default).
aggregate_documentsSums/averages/min/max/counts over indexed documents, grouped by vendor, currency, type, month, and more.
index_document(Re)index one document into the searchable index — after corrections or to backfill.

How to install the Gemina MCP Server

{
  "mcpServers": {
    "gemina": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.gemina.co/api/v1/mcp/",
        "--header",
        "X-API-Key:${GEMINA_API_KEY}"
      ],
      "env": {
        "GEMINA_API_KEY": "YOUR_GEMINA_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GEMINA_API_KEYDeclared in the maintainer’s client configuration.Check documentation