io.github.kodandy/jp-m2m-gateway
Raw Japanese regulatory data for AI agents: pension, gazette, gBizINFO. x402-metered (USDC).
Open source Repository Open in the app JSON README (API)
About
Raw Japanese regulatory data for AI agents: pension, gazette, gBizINFO. x402-metered (USDC).
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- kodandy
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.1.0
- Last push
- 2026-06-11T15:35:05Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:00:21
- Updated
- 2026-08-29 04:00:21
- Origin id
io.github.kodandy/jp-m2m-gateway
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](LICENSE)