MCP.Market

jPOS MCP Server

by mohisyed·io.github.mohisyed/jpos-mcp-server·v0.1.1·4 stars
No reviews yet

MCP server for jPOS and ISO 8583. Deterministic payment protocol tools for AI agents.

B82/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Growing

4 stars22 downloads/wk

Reviews

Write one

Nobody has reviewed jPOS MCP Server yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

jPOS MCP Server tools (7)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • build_message

    Validate an ISO 8583 message field dictionary. Checks MTI validity, missing mandatory fields, value length violations, and potential real PANs (detected via Luhn algorithm — rejected for safety). Only test PANs (4111111111111111 etc.) are accepted.

  • decode_mti

    Decode a 4-digit MTI into version, message class, function, and origin. For request messages (function digit = 0), returns the expected response MTI.

  • generate_packager
  • health

    Return server health status: version, tool count, and ChromaDB chunk count.

  • lookup_field

    Return the complete ISO 8583 specification for a data element number. Returns: name, format (FIXED/LLVAR/LLLVAR), type, max_length, jpos_class_bcd, jpos_class_ascii, mandatory_for_mtis, pci_sensitive, notes. Use this before writing any GenericPackager XML.

  • search_jpos

    Search jPOS documentation using hybrid semantic + keyword search.

  • validate_descriptor

    Validate a jPOS Q2 deploy descriptor XML file. Checks: well-formed XML, required attributes, channel/QMUX/TM-specific rules, common property name typos.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan18 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 168 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How jPOS MCP Server compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 73% of 1,761 Finance servers
Tools
7
the typical Finance server has 8
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
4
more than 85% of 946 Finance servers
Downloads a week
22
more than 8% of 421 Finance servers with a package

What its tools let an agent do: 6 read · 1 create

Install jPOS MCP Server in Claude Code, Cursor or VS Code

claude mcp add jpos-mcp-server -- uvx jpos-mcp-server
Add to Cursor

What the publisher says

From the jPOS MCP Server repository's README, as published. We do not edit it. Read it on GitHub

jPOS MCP Server

mcp-name: io.github.mohisyed/jpos-mcp-server

The first open-source MCP server for jPOS and ISO 8583.

Claude validating a real ISO 8583 financial transaction request using deterministic tools. No guessing — every answer comes from verified data.

An MCP server that gives AI agents (Claude, Cursor, VS Code Copilot) deterministic, verified access to ISO 8583 field specs, MTI decoding, jPOS packager XML generation, deploy descriptor validation, message building, and jPOS documentation search.

No more guessing packager class names. No more scrolling a 300-page PDF. Call a tool, get the right answer.

Table of Contents

  • Quickstart
  • Tools
  • Architecture
  • Testing
  • Knowledge Base (RAG)
  • Docker
  • Claude Desktop Setup
  • MCP Inspector
  • Security
  • Troubleshooting
  • Roadmap
  • Contributing

Quickstart

Prerequisites: Python 3.11+ and uv package manager.

# 1. Clone and install
git clone https://github.com/mohisyed/JPOS-MCP.git
cd JPOS-MCP
uv sync

# 2. (Optional) Set up the knowledge base for semantic search
mkdir -p knowledge/sources
curl -o knowledge/sources/proguide.pdf https://jpos.org/doc/proguide-draft.pdf
uv run python knowledge/ingest.py

# 3. Add to Claude Desktop (see Claude Desktop Setup below)

All 6 tools work immediately after step 1. Step 2 enables the search_jpos RAG tool with real documentation.

Tools

Why deterministic tools instead of LLM inference?

LLMs can guess that field 35 uses IFALLVAR, but they sometimes hallucinate class names like IFALLTRACK2 (doesn't exist). Our tools read from data/isofields.json — a verified lookup table — so the answer is always correct. The AI decides which tool to call; our code provides the facts*.

Architecture

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

jPOS MCP Server: common questions

Is jPOS MCP Server safe?
Mostly: it is graded B (82/100). Read the jPOS MCP Server safety report
How do I install jPOS MCP Server?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does jPOS MCP Server need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is jPOS MCP Server maintained?
The last commit was 206 days ago (2026-04-12). The latest release is v0.1.1.
What can I use instead of jPOS MCP Server?
Servers from other publishers that do the same job: three.ws Agent Payments MCP server, Yolfi Payments MCP server and X402 List MCP server.
How does jPOS MCP Server compare with other Finance MCP servers?
safety score 82/100 (higher than 73% of 1,761 Finance servers); tools 7 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to jPOS MCP Server

Same job from other publishers: the closest match first, then the best rated.