# mcp-jumio

This MCP server connects an agent to Jumio for identity, document, liveness, and AML checks. It fits KYX workflows that need Jumio data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/identity/jumio
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-jumio

## What it does

mcp-jumio exposes 20 Jumio tools to the agent. They can create an end-user account, start a KYC transaction, read its status and full decision, extract identity-document fields, compare a selfie with the document image, and inspect liveness. The server also handles credentials, facemaps, AML and watchlist results, callbacks, retries, cancellation, and GDPR deletion.

The main flow creates an account once, starts a transaction, and sends the user to the returned `redirectUrl` for capture. The agent then polls the transaction, reads the decision payload, gets document and face-match results, and sends back an `APPROVED` or `REJECTED` status. Jumio authentication uses HTTP Basic.

Set `JUMIO_API_TOKEN`, `JUMIO_API_SECRET`, and `JUMIO_USER_AGENT` before starting the server. `JUMIO_REGION` selects `us`, `eu`, or `sg`. Jumio rejects calls without a custom `User-Agent`, so the integration cannot reach the API without `JUMIO_USER_AGENT`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `JUMIO_API_TOKEN`, `JUMIO_API_SECRET`, `JUMIO_USER_AGENT`, `JUMIO_REGION` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env JUMIO_API_TOKEN=<JUMIO_API_TOKEN> --env JUMIO_API_SECRET=<JUMIO_API_SECRET> --env JUMIO_USER_AGENT=<JUMIO_USER_AGENT> --env JUMIO_REGION=<JUMIO_REGION> --transport stdio jumio -- npx -y @codespar/mcp-jumio
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add jumio --env JUMIO_API_TOKEN=<JUMIO_API_TOKEN> --env JUMIO_API_SECRET=<JUMIO_API_SECRET> --env JUMIO_USER_AGENT=<JUMIO_USER_AGENT> --env JUMIO_REGION=<JUMIO_REGION> -- npx -y @codespar/mcp-jumio
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "jumio": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-jumio"
            ],
            "env": {
                "JUMIO_API_TOKEN": "<JUMIO_API_TOKEN>",
                "JUMIO_API_SECRET": "<JUMIO_API_SECRET>",
                "JUMIO_USER_AGENT": "<JUMIO_USER_AGENT>",
                "JUMIO_REGION": "<JUMIO_REGION>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "jumio": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-jumio"
            ],
            "env": {
                "JUMIO_API_TOKEN": "<JUMIO_API_TOKEN>",
                "JUMIO_API_SECRET": "<JUMIO_API_SECRET>",
                "JUMIO_USER_AGENT": "<JUMIO_USER_AGENT>",
                "JUMIO_REGION": "<JUMIO_REGION>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e JUMIO_API_TOKEN=<JUMIO_API_TOKEN> -e JUMIO_API_SECRET=<JUMIO_API_SECRET> -e JUMIO_USER_AGENT=<JUMIO_USER_AGENT> -e JUMIO_REGION=<JUMIO_REGION> jumio npx -y @codespar/mcp-jumio
```
Replace <…> with your own values

## When to use it
- start a Jumio KYC transaction
- read identity fields from a document
- compare a selfie with the document photo
- inspect AML and watchlist results
- send a verification decision through a callback

## Example prompts
- Create a Jumio end-user account and start a KYC transaction for it.
- Check the transaction status, then show the document fields and liveness result.
- Fetch the AML result for this transaction and set its merchant status to `APPROVED` when the checks pass.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md