---
name: muxgate-jp
description: Use MuxGate JP to call 111+ Japanese business, government, geo/weather, and public APIs through one unified REST gateway, parallel Aggregators, BYOK provider vault, or Remote MCP. Use when generating Japanese invoice PDFs, validating Qualified Invoice T-numbers, formatting Zengin 120-byte bank transfers, converting Wareki/holidays, querying e-Gov/GSI/JMA/jGrants/NDL, or connecting Claude/Cursor/Antigravity via MCP.
---

# MuxGate JP AgentSkill

Base URL: `https://muxgate.pages.dev`
OpenAPI 3.0.3 Spec: `https://muxgate.pages.dev/openapi.json`
Interactive Docs: `https://muxgate.pages.dev/docs`

## 1. Choose Your Access Path

1. **MuxGate API (REST)**: Direct HTTP `POST` calls from scripts, Dify, GAS, Make, or apps.
   - Authenticated: `/v1/*` with `Authorization: Bearer <API_KEY>` (or `X-API-Key: <API_KEY>`).
   - Free Sandbox (no key, 20 req/min/IP, 100 KB max): replace `/v1/` with `/sandbox/`.
2. **MuxGate MCP (Remote MCP — 18 Tools)**: Streamable HTTP JSON-RPC 2.0 at `https://muxgate.pages.dev/mcp`.
   - `initialize` and `tools/list` are public; `tools/call` accepts `X-API-Key` (or `muxgate-sandbox-demo` for sandbox testing).
3. **MuxGate Aggregators (Parallel Fan-Out)**:
   - `POST /v1/weather/aggregate`: Parallel fan-out across JMA Forecast, JMA Warning, Open-Meteo, and Solar/WBGT (`unified` + `by_source`).
   - `POST /v1/public/book/aggregate`: Parallel fan-out across openBD and NDL Search.

## 2. Core Endpoints Quick Reference

- **Japanese Business & Accounting**:
  - `POST /v1/pdf/invoice` — Japanese Invoice / Estimate / Receipt PDF (`doc_type`: `invoice` | `estimate` | `receipt`)
  - `POST /v1/invoice/validate` — Qualified Invoice `T` + 13-digit check-digit validation
  - `POST /v1/zengin/generate` — Zengin 120-byte fixed-length bank transfer file
  - `POST /v1/tax/calc` — Withholding tax (10.21% / 20.42%), stamp duty, consumption tax rounding
  - `POST /v1/text/normalize` — Normalize `㈱`, full-width/half-width kana, addresses, phone numbers
  - `POST /v1/wareki/convert` — Seireki ↔ Wareki + Japanese holidays & business day check
  - `POST /v1/ogp/render` — 1200×630 Japanese OGP SVG/JSON
- **Official Japanese Government APIs (No Auth Required)**:
  - `POST /v1/gov/law/search` & `/v1/gov/law/detail` — Digital Agency e-Gov Law API v2
  - `POST /v1/gov/jgrants/subsidies` — Digital Agency jGrants public subsidies search
  - `POST /v1/gov/geo/geocode` & `/v1/geo/reverse` — GSI Geocoding, Reverse Geocoding & Elevation
  - `POST /v1/gov/weather/forecast`, `/v1/gov/jma/quake`, `/v1/gov/jma/warning` — JMA Weather, Earthquakes, Warnings
  - `POST /v1/gov/ndl/search` & `/v1/public/diet/search` — National Diet Library Search & Diet Minutes
  - `POST /v1/gov/municipality/lookup` — JIS X 0401 / X 0402 municipality codes
- **Selected Public & Geo/Weather APIs**:
  - `POST /v1/public/zip/lookup` (zipcloud), `/v1/public/book/isbn` (openBD), `/v1/public/fx/rate` (Frankfurter ECB), `/v1/public/station/search` (HeartRails), `/v1/geo/zip-enrich`, `/v1/weather/point` (Open-Meteo)
- **Domain Modules (111+ Total)**:
  - `/v1/calendar/*`, `/v1/validate/*`, `/v1/text/*`, `/v1/finance/*`, `/v1/dev/*`
  - Discover all endpoints dynamically: `GET /sandbox/dashboard/catalog`

## 3. BYOK Official Government Keys (LiteLLM-Style Vault)

For key-gated government APIs (`gbizinfo`, `mlit_reinfolib`, `estat`, `edinet`, `jquants`, `jpo_patent`, `nta_invoice`), pass your official key either:
- Per-request via `X-Provider-Key: <OFFICIAL_KEY>` header, OR
- Saved once in the MuxGate Console (`POST /v1/keys/providers`).

## 4. Remote MCP Configuration

```json
{
  "mcpServers": {
    "muxgate": {
      "type": "streamable-http",
      "url": "https://muxgate.pages.dev/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
```
