# jp-m2m-gateway [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/kodandy/jp-m2m-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/jp-m2m-gateway

## Description
Raw Japanese regulatory data for AI agents: pension, gazette, gBizINFO. x402-metered (USDC).

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "jp-m2m-gateway": {
    "url": "https://modelcontextprotocol.io"
  }
}
```

## Documentation & README

# JP Raw M2M Data Gateway — MCP Server

Remote [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server exposing **raw Japanese regulatory corporate data** to AI agents, metered per call with the [x402 payment protocol](https://github.com/coinbase/x402).

- **MCP endpoint (Streamable HTTP, stateless):** `https://jp-m2m-gateway-62ko7b2uwa-an.a.run.app/mcp`
- Machine index: [llms.txt](https://jp-m2m-gateway-62ko7b2uwa-an.a.run.app/llms.txt) · API contract: [openapi.yaml](https://jp-m2m-gateway-62ko7b2uwa-an.a.run.app/openapi.yaml) · Catalog: [JSON-LD dataset pages](https://jp-m2m-gateway-62ko7b2uwa-an.a.run.app/)

Unlike generic corporate registries, this gateway serves **un-aggregated, regulatory-enforced raw logs** for Japanese companies, keyed by the 13-digit corporate number (法人番号):

| Tool | Dataset | Price |
|---|---|---|
| `list_company_datasets` | Catalog lookup for one corporate number | **Free** |
| `get_pension_headcount_log` | Japan Pension Service monthly insured-headcount raw log (month-over-month deltas) | 0.05 USDC / call |
| `get_gazette_financials` | Official Gazette (官報) statutory financial disclosures, raw text blocks | 0.05 USDC / call |
| `get_government_records` | gBizINFO procurement / subsidy / certification raw log | 0.05 USDC / call |

## Connect

Listed on [Smithery](https://smithery.ai/server/o9o64456583/jp-m2m-gateway) and the [official MCP Registry](https://registry.modelcontextprotocol.io) (`io.github.kodandy/jp-m2m-gateway`).

Claude Code:

```bash
claude mcp add --transport http jp-m2m https://jp-m2m-gateway-62ko7b2uwa-an.a.run.app/mcp
```

Generic MCP client configuration:

```json
{
  "mcpServers": {
    "jp-m2m": {
      "type": "streamable-http",
      "url": "https://jp-m2m-gateway-62ko7b2uwa-an.a.run.app/mcp"
    }
  }
}
```

No API key and no initialize handshake required — the server is stateless; `tools/call` works directly.

## How payment works (x402)

Paid tools return a structured **HTTP 402 payment challenge** instead of data:

```json
{
  "status": 402,
  "error": "Payment Required",
  "dataset": "pension",
  "amount_usdc": 0.05,
  "x402": { "header": "X-402-Payment-Required", "descriptor": "usdc_request_mock_v1_base_…" },
  "resource": "https://…/v1/companies/{corporate_id}/pension",
  "how_to_pay": "Settle 0.05 USDC via x402, then retry the resource with an X-PAYMENT header."
}
```

Per-resource descriptors are stable. x402 settlement (USDC on Base, testnet first) is being enabled during the current private beta; agents that send `X-PAYMENT` retries are prioritized for access.

## Notes

- **Machine-to-machine only.** Human/browser UX is intentionally not provided — browsers receive a plain-text 402 by design.
- Status: **closed private beta.** Endpoints, pricing and datasets may change.
- Source of the gateway lives in a private repository; this repo hosts the public MCP server documentation and registry manifest.

## License

[MIT](https://github.com/kodandy/jp-m2m-mcp/blob/HEAD/LICENSE)