Skip to main content
J

Jumio

@codespar/mcp-jumio · v0.2.2

🌐 GlobalIdentity & KYCAuth · API Keybeta20 tools4 env vars

Global KYC enterprise tier — deeper fraud intelligence, longer operator history. Target: banks, large fintechs, regulated commerce. Regional hosts (amer-1 / emea-1 / apac-1). Verified against docs.jumio.ai.

Get started · freeView docs

MIT · runs locally with your own credentials

Package
@codespar/mcp-jumio
Version
0.2.2
npm dist-tag
latest
Category
Identity & KYC
Auth
API Key
Country
🌐 Global
License
MIT
Transport
stdio · streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables4 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 20 tools. Try initiate_account first.
terminal
# Claude Code claude mcp add jumio -e JUMIO_API_SECRET=… -e JUMIO_API_TOKEN=… -e JUMIO_REGION=… -e JUMIO_USER_AGENT=… -- npx -y @codespar/mcp-jumio@0.2.2 # then: /mcp to confirm the server is connected
Environment variables4 variables
JUMIO_API_SECRETJumio API secret (sent as the password component of HTTP Basic auth).requiredsecret
JUMIO_API_TOKENJumio API token (sent as the username component of HTTP Basic auth).required
JUMIO_REGIONRegion 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'.optional
JUMIO_USER_AGENTMerchant User-Agent string. Jumio requires a custom User-Agent header identifying the calling application (e.g. 'AcmeCorp KYX/1.0').required

Names read from the package code (@codespar/mcp-jumio@0.2.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demoinitiate_account

"Create a persistent Jumio end-user account. An account groups all workflow executions"

tools/callinitiate_accountresult returned

Tools

What your agent can call.

20 tools, as the package's tools/list returns them.

initiate_account

Create a persistent Jumio end-user account. An account groups all workflow executions (KYC transactions) for the same real-world user, enabling re-use of previously verified data and longitudinal fraud signals.

initiate_transaction

Start a new KYC workflow execution on an existing account. Returns a `redirectUrl` — redirect the end user there to complete the Jumio-hosted capture flow (document + selfie). Poll get_transaction for status afterwards.

get_transaction

Retrieve a workflow execution summary — status ('INITIATED' | 'PROCESSED' | 'SESSION_EXPIRED' | 'TOKEN_EXPIRED' | 'ACQUIRED'), decision outcome, and capability-level results. Poll this to track progress.

list_transactions

List workflow executions for an account. Useful for auditing or rebuilding state after a webhook failure.

get_transaction_details

Retrieve the full result payload for a workflow execution — all capability outputs (extraction, liveness, similarity, watchlist, etc). Use after status = 'PROCESSED'.

retrieve_document_data

Retrieve extracted fields from the ID document (name, DOB, document number, expiry, issuing country, MRZ, etc). Requires a completed workflow that included a document capability.

retrieve_similarity_score

Retrieve the facial similarity result (selfie vs document photo). Returns match decision plus confidence score. Requires a completed workflow that included a similarity/selfie capability.

delete_transaction

Delete a workflow execution (GDPR right-to-erasure). Removes captured images, extracted data, and decision audit trail for this transaction on Jumio's side.

update_transaction_status

Update the merchant-side status of a workflow execution (PATCH). Use to record your final accept/reject decision back on the Jumio transaction — helpful for Jumio's fraud model feedback loop and for dashboard reporting.

retrieve_credentials

List the credentials (captured artefacts: ID front/back, selfie, proof-of-address, etc) for a workflow execution. Each credential carries a parts[] array with URLs to download the stored images / PDFs.

cancel_transaction

Cancel an in-flight workflow execution (status 'INITIATED' or 'ACQUIRED'). Use when the user abandons the flow or you decide upstream not to proceed; finalises the workflow as cancelled and stops further processing.

retry_transaction

Retry a failed, expired, or rejected workflow execution. Creates a new workflow execution on the same account, optionally re-using the original workflow definition and customer references.

Names and descriptions come from the package's tools/list (@codespar/mcp-jumio@0.2.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

The CodeSpar runtime does not route this server. Mount it in your client over stdio · streamable-http.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Jumio MCP server?

Run npx -y @codespar/mcp-jumio@0.2.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Jumio?

Jumio exposes 20 tools for identity & kyc. Your agent calls them directly; the full list is above.

How does Jumio authenticate, and how are credentials stored?

Jumio uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Jumio handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Jumio open source? How do I report a bug?

Yes. Jumio is MIT-licensed and published on npm as @codespar/mcp-jumio, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Pairs well with

Identity & KYC · same category.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Jumio — MCP server · 20 tools | CodeSpar