io.github.codespar/mcp-jumio
io.github.codespar/mcp-jumio · 273 stars · TypeScript · MIT
MCP server MCP server for Jumio — global identity verification + KYX: documents, liveness, AML screening
Install
The repo has no one-line install. Follow its README.
Published as
- npm
@codespar/mcp-jumiostdio
From the server's entry in the official MCP Registry.
Configuration
| Name | Set as | What it is |
|---|---|---|
JUMIO_API_TOKENRequired | Env var | Jumio API token (sent as the username component of HTTP Basic auth). |
JUMIO_API_SECRETRequired · Secret | Env var | Jumio API secret (sent as the password component of HTTP Basic auth). |
JUMIO_USER_AGENTRequired | Env var | Merchant User-Agent string. Jumio requires a custom User-Agent header identifying the calling application (e.g. 'AcmeCorp KYX/1.0'). |
JUMIO_REGIONOptional | Env var | Region for the API host: 'us' (api.amer-1.jumio.ai), 'eu' (api.emea-1.jumio.ai), 'sg' (api.apac-1.jumio.ai). Defaults to 'us'. |
Files
@codespar/mcp-jumio
MCP server for Jumio — global enterprise identity verification (KYX / Netverify).
Jumio is the identity layer banks and large regulated fintechs reach for when Onfido isn't deep enough on fraud-pattern detection. Longer operator history, richer risk intelligence, purpose-built for regulated commerce at scale.
Third entry in CodeSpar's identity category. Completes the tier:
| Server | Strength |
|---|---|
| Unico | BR leader — local KYC, PEP, court records, Receita Federal biometric pool |
| Onfido | Global challenger — clean developer API, 195+ countries, strong SDK story |
| Jumio (this) | Global enterprise — deeper fraud-pattern detection, longer operator history, bank-grade |
When to pick Jumio
- Regulated bank or tier-1 fintech where auditors expect a legacy-credible vendor
- High-value onboarding where fraud-loss >> verification cost
- Deep fraud intelligence matters (velocity checks, device/session signals, longitudinal identity graph)
- You already run Jumio elsewhere in the org and want a single KYC stack
Pair with Unico for Brazil-resident users (CPF + Receita biometric match); use Jumio for the rest of the world.
Tools (20)
| Tool | Purpose |
|---|---|
initiate_account |
Create a persistent Jumio end-user account. |
initiate_transaction |
Start a new KYC workflow execution on an existing account. |
get_transaction |
Retrieve a workflow execution summary — status ('INITIATED' | 'PROCESSED' | 'SESSION_EXPIRED' | 'TOKEN_EXPI... |
list_transactions |
List workflow executions for an account. |
get_transaction_details |
Retrieve the full result payload for a workflow execution — all capability outputs (extraction, liveness, s... |
retrieve_document_data |
Retrieve extracted fields from the ID document (name, DOB, document number, expiry, issuing country, MRZ, e... |
retrieve_similarity_score |
Retrieve the facial similarity result (selfie vs document photo). |
delete_transaction |
Delete a workflow execution (GDPR right-to-erasure). |
update_transaction_status |
Update the merchant-side status of a workflow execution (PATCH). |
retrieve_credentials |
List the credentials (captured artefacts: ID front/back, selfie, proof-of-address, etc) for a workflow exec... |
cancel_transaction |
Cancel an in-flight workflow execution (status 'INITIATED' or 'ACQUIRED'). |
retry_transaction |
Retry a failed, expired, or rejected workflow execution. |
retrieve_extraction_data |
Retrieve raw OCR / extraction capability output for a completed workflow — every extracted field with its s... |
retrieve_liveness_result |
Retrieve the liveness capability result — passive/active liveness decision plus per-frame anti-spoofing sco... |
retrieve_facemap |
Retrieve the biometric facemap (face template) generated during a workflow. |
retrieve_screening_result |
Retrieve AML / watchlist screening output for a workflow — sanctions hits, PEP hits, adverse-media hits wit... |
retrieve_data_export |
Retrieve a full GDPR-compliant data export for an account — every workflow execution, captured image URL, e... |
register_callback_url |
Set or update the account-level webhook (callback) URL where Jumio POSTs workflow result notifications. |
delete_account |
Delete a Jumio end-user account and every workflow execution under it (GDPR right-to-erasure). |
list_accounts |
List Jumio end-user accounts under your authorizer / merchant. |
Flow
initiate_account (once per end-user)
-> initiate_transaction returns redirectUrl
-> user completes capture at redirectUrl
-> get_transaction poll until status = PROCESSED
-> get_transaction_details full decision payload
-> retrieve_document_data extracted ID fields
-> retrieve_similarity_score face-match result
-> update_transaction_status ("APPROVED" / "REJECTED" — feedback loop)
Install
npm install @codespar/mcp-jumio
Environment
JUMIO_API_TOKEN="..." # API token (required) JUMIO_API_SECRET="..." # API secret (required, secret) JUMIO_USER_AGENT="AcmeCorp KYX/1.0" # required by Jumio — identifies the caller JUMIO_REGION="us" # 'us' | 'eu' | 'sg'. Default 'us'.
Authentication
HTTP Basic, with API token as user and API secret as password:
Authorization: Basic base64(JUMIO_API_TOKEN:JUMIO_API_SECRET)
User-Agent: <JUMIO_USER_AGENT>
Jumio rejects requests without a custom User-Agent header — use something that identifies your merchant + integration (e.g. "AcmeCorp KYX/1.0"). The server wires both headers automatically.
Regional hosts
| Region | Host |
|---|---|
| US (default) | https://api.amer-1.jumio.ai |
| EU | https://api.emea-1.jumio.ai |
| SG / APAC | https://api.apac-1.jumio.ai |
All endpoints live under /api/v1.
Run
# stdio (default — for Claude Desktop, Cursor, etc) npx @codespar/mcp-jumio # HTTP (for server-to-server testing) MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-jumio
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT
Facts
- Kind
- MCP server
- Group
- Uncategorized
- Stars
- 273
- License
- MIT
- Language
- TypeScript
- Last push
- 2026-09-27
- Forks
- 50
- MCP Registry
- io.github.codespar/mcp-jumio
- Homepage
- codespar.dev/servers
- Topics
- agentic-commerce, ai-agents, brazil, claude, fintech, latin-america, llm-tools, mcp, model-context-protocol, nfe, open-finance, payments, pix
- 1REAio.github.morluto/reaReverse engineer anything from your terminal or agent with one CLI and MCP server.125.3k
- 2com.browser-use/browser-usecom.browser-use/browser-useControl a real Chrome browser to complete any task: fill forms, extract data, book flights.117.7k
- 3World Monitorapp.worldmonitor/mcpLive markets, conflicts, country risk, chokepoints, energy, and China decision signals. 93 tools.88.3k
- 4Scrapling MCP Serverd4vinci/scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scraplingdev86.9k
- 5Everythingmodelcontextprotocol/serversThis MCP server attempts to exercise all the features of the MCP protocol. It is not intended to be a useful server, but rather a test server for builders of MCP clients. It implements prompts, tools, resources, sampling, and more to showcase MCP capabilities.85.8k
- 6Fetchmodelcontextprotocol/serversA Model Context Protocol server that provides web content fetching capabilities. This server enables LLMs to retrieve and process content from web pages, converting HTML to markdown for easier consumption.85.8k