com.mart402/extract

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Web extraction, OCR (Japanese-strong), invoice and company data for AI agents. x402, no API key.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "extract": {
      "url": "https://mart402.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (35)

• get_catalog read-only

  Mart402 product catalog: all products, prices, payment config, error codes, rate limits. Free.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• quote_parse read-only

  Free quote for PDF parsing: page count, route (text/scan-OCR) and the exact final price, before any payment. Use the returned quote_id with parse_document (on /mcp or /mcp/docs).

  Parameters:

  • url (required) — string — PDF URL

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_receipt read-only

  Re-fetch a previously paid result for free by receipt id (every paid response carries receipt_id).

  Parameters:

  • receipt_id (required) — string — receipt_id from a paid response (rcpt_...)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_x402_services read-only

  Search the Market402 verified index of the whole x402 economy by capability (e.g. 'ocr', 'market-data'). Every result is a real, probed resource with a measured 402 Score. Free.

  Parameters:

  • q (required) — string — Capability keyword, e.g. 'ocr', 'market-data', 'weather'
  • limit — integer — Maximum results (default 10)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• get_sample read-only

  Free recorded sample response for a paid product (from real production runs, marked sample:true) - see the exact response shape before paying anything. Available: document-pipeline, enrich, extract, jp-bonus-net, jp-business-days, jp-company, jp-consumption-tax, jp-crypto-tax, jp-dependent-threshold, jp-mortgage, jp-overtime-wage, jp-payroll-net, jp-payroll-suite, jp-payslip-audit, jp-retirement-tax, jp-social-insurance, meal-vision, ocr, parse, pdf-info, pdf-merge, pdf-pages, portrait-analysis, report-pack, structured, style-profile, style-report, verify.

  Parameters:

  • product (required) — string — One of: document-pipeline, enrich, extract, jp-bonus-net, jp-business-days, jp-company, jp-consumption-tax, jp-crypto-tax, jp-dependent-threshold, jp-mortgage, jp-overtime-wage, jp-payroll-net, jp-payroll-suite, jp-payslip-audit, jp-retirement-tax, jp-social-insurance, meal-vision, ocr, parse, pdf-info, pdf-merge, pdf-pages, portrait-analysis, report-pack, structured, style-profile, style-report, verify. Product id (see the enum)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• portrait_precheck read-only

  FREE analyzability check before paying for portrait_analysis: is a face detectable, is the photo quality good enough (clipping/color cast)? Deterministic, no LLM. 10/hour/IP.

  Parameters:

  • image_url — string — Absolute http(s) URL of the image (JPEG/PNG/WebP)
  • image_base64 — string — Base64-encoded image bytes (alternative to image_url)

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• operator_history read-only

  Free 12-week measured score history for any x402 operator from the Market402 index (weekly series, trend, volatility, badge). Check a seller's record before your agent pays an unfamiliar endpoint.

  Parameters:

  • operator (required) — string — operator domain, e.g. mart402.com

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• extract_url

  Extract a web page to clean Markdown + metadata (auto JS rendering, robots.txt respected). $0.005 fast / $0.01 rendered; cached results half price. Choose this when you need a web PAGE as clean Markdown to read yourself; to fill a schema use structured_extract, for a PDF use pdf_info then parse_document.

  Parameters:

  • url (required) — string — Absolute http(s) URL of the input (web page or PDF, per tool)
  • ttl — integer — cache seconds (0 = no cache)
  • mode — string — Extraction mode: auto (fast with rendered fallback), fast, heavy
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• parse_document

  Parse a PDF to structured Markdown (hallucination-guarded OCR for scanned pages, Japanese-strong). Pass url (one step: the 402 quotes the exact price for that PDF) or quote_id from quote_parse (price fixed by the quote). One of the two is required. Choose this when the input is a PDF and you want its full text as Markdown; call pdf_info first if you do not know whether it is scanned, and use document_pipeline instead for invoices you also want verified.

  Parameters:

  • url — string — Absolute http(s) URL of the PDF (one-step form)
  • quote_id — string — quote_id returned by quote_parse (price is fixed by the quote)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• ocr_image

  OCR one image to text with dual-engine consensus, calibrated confidence and per-segment corroboration. Japanese-strong. Flat $0.05/image. Choose this when the input is an IMAGE (photo, screenshot, receipt); for PDFs use parse_document.

  Parameters:

  • lang — string — One of: japanese, latin. Expected script for OCR: japanese or latin
  • image_url — string — Absolute http(s) URL of the image (JPEG/PNG/WebP)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • image_base64 — string — Base64-encoded image bytes (alternative to image_url)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• verify_invoice

  Verify extracted invoice fields: arithmetic consistency, line-item totals, JP registration number check-digit + corporate-number existence observation (official Japan NTA registry), accounting-ready JSON. $0.015/call. Choose this when you already HAVE invoice fields (from your own extraction) and only need them checked; to start from a PDF use document_pipeline.

  Parameters:

  • fields (required) — object — Extracted invoice fields: total_jpy, tax_jpy, reg_no, invoice_no, issue_date, due_date, vendor, customer
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • line_items — array — Optional line items [{description, amount_jpy}] to reconcile against the subtotal

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• enrich_company

  Company name/domain/URL to a verified profile from primary sources + GLEIF LEI and Japan NTA corporate-number registries. Per-field evidence + confidence, honest nulls; unresolved lookups never charged. $0.03/company. Choose this when you have a company NAME or DOMAIN and need a registry-grounded profile (GLEIF LEI / Japan NTA) with per-field evidence; pass country_hint 'jp' for Japanese companies.

  Parameters:

  • company (required) — string — Company name, domain or URL
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • country_hint — string — ISO country hint for registry lookups, e.g. 'jp'

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• structured_extract

  Fill YOUR JSON schema from any URL (hybrid LLM + deterministic canonicalization). $0.03/call. Choose this when you have your OWN JSON schema to fill from any page; for company profiles use enrich_company or jp_company_profile.

  Parameters:

  • url (required) — string — Absolute http(s) URL of the input (web page or PDF, per tool)
  • schema (required) — object — {key: description} pairs
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • instructions — string — optional extra guidance for filling the schema

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_company_profile

  Japanese company site to a standard profile JSON (name, address, representative, capital, contact). $0.03/site. Choose this when you have the URL of a Japanese company's OWN site and want its standard profile fields read from the page; for name/domain lookups use enrich_company (country_hint: jp).

  Parameters:

  • url (required) — string — Absolute http(s) URL of the input (web page or PDF, per tool)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• document_pipeline

  One call: PDF invoice to parse (hallucination-guarded OCR) + field extraction + arithmetic verification (+optional issuer enrich). Flat $0.05/document; inputs validated before payment. Choose this when a PDF is an invoice/receipt and you want parse + field extraction + arithmetic verification in one paid call; for text only use parse_document.

  Parameters:

  • url (required) — string — Absolute http(s) URL of the input (web page or PDF, per tool)
  • enrich — boolean — Also run issuer enrichment on the parsed invoice
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• pdf_merge

  Merge 2-10 PDFs into one, in order. Deterministic, $0.003.

  Parameters:

  • urls (required) — array — List of absolute PDF URLs, in order (2-10)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• pdf_pages

  Extract pages from a PDF by 1-based ranges (e.g. 1-3,7) into a new PDF. Deterministic, $0.002.

  Parameters:

  • url (required) — string — Absolute http(s) URL of the input (web page or PDF, per tool)
  • pages (required) — string — 1-based page ranges, e.g. '1-3,7'
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• pdf_info

  PDF facts before you pay for parsing: pages, metadata, per-page text volume, scanned-or-not estimate. $0.001. Choose this first for any unknown PDF (cheapest real call); then parse_document, pdf_pages or document_pipeline.

  Parameters:

  • url (required) — string — Absolute http(s) URL of the input (web page or PDF, per tool)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• meal_vision

  Analyze a meal photo to itemized nutrition JSON: dishes, portions, kcal, macros with per-item confidence, reference-object scale calibration, scene-complexity detection, a disclosed calibrated kcal range, PFC balance ratios and alcohol-aware 4/4/9 cross-checks. Calibrated on 30 weighed meals (range contained truth in 26/30). Every call is a 3-run consensus with disclosed spread + item agreement. $0.05/image.

  Parameters:

  • hints — string — cuisine/context hint, e.g. 'Japanese teishoku, small diet portions' - measurably improves accuracy on regional home-style meals
  • image_url — string — Absolute http(s) URL of the image (JPEG/PNG/WebP)
  • pack_code — string — retry credit issued after an unbilled failed call (replaces payment)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • image_base64 — string — Base64-encoded image bytes (alternative to image_url)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• style_profile

  Integrated styling verdict: seasonal color (measured colorimetry consensus) + face-impression zone (published geometry rules) + body frame + integration rules (palette subset, taste, silhouette, modifiers). 1-3 face photos, optional full-body + questionnaire. Flat $0.05/call. Choose this when you want the integrated styling analysis as JSON to use or render yourself; it is the same analysis that style_report turns into a PDF. For color only use portrait_analysis.

  Parameters:

  • style — string — One of: feminine, masculine, neutral. Styling context: feminine, masculine or neutral
  • images — array — Up to 3 objects {image_url | image_base64}
  • image_url — string — Absolute http(s) URL of the image (JPEG/PNG/WebP)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • image_base64 — string — Base64-encoded image bytes (alternative to image_url)
  • questionnaire — object — Optional frame questionnaire answers (see /catalog input spec)
  • body_image_url — string — Optional full-body photo URL for frame estimation
  • body_image_base64 — string — See the product's input spec in /catalog

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• style_report

  Client-ready deliverable: the style-profile analysis rendered as a finished PDF report in English or Japanese (palette with color names, style-aware outfit formulas, virtual draping boards with disclosed candidate conflicts, honest confidence) returned as report_pdf_base64 + full profile JSON. For agents serving human end-clients. Flat $2.99/call, or $1.99/unit with a prepaid report_pack credit (pass pack_code). Choose this when the result goes to a HUMAN end-client as a finished document; if you will present the result yourself, style_profile returns the same analysis as JSON for less.

  Parameters:

  • name — string — client name printed on the report (same field as REST; client_name is accepted as an alias)
  • style — string — One of: feminine, masculine, neutral. Styling context: feminine, masculine or neutral
  • images — array — 1-3 face photos
  • language — string — report language
  • image_url — string — Absolute http(s) URL of the image (JPEG/PNG/WebP)
  • pack_code — string — prepaid credit from report_pack (replaces payment)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • image_base64 — string — Base64-encoded image bytes (alternative to image_url)
  • questionnaire — object — optional answers (see /catalog style-report input)
  • body_image_url — string — optional full-body photo URL (body-shape layer)
  • body_image_base64 — string — optional full-body photo as base64

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• report_pack

  Volume pricing for style_report: one $19.90 payment returns 10 single-use credit codes ($1.99/unit vs $2.99 single, en or ja, no expiry). Treat codes like cash. Not an analysis: it buys prepaid style_report credits. Choose this only when you expect to produce several style_report PDFs; pass each code as pack_code to style_report.

  Parameters:

  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• portrait_analysis

  Personal color analysis from 1-3 portraits: measured pixel colorimetry (CIELAB/ITA) cross-checked against vision-model attributes, cross-photo lighting consistency, then a published deterministic rule table gives the 4-season verdict with palette and style advice. No identification; images not stored. Flat $0.05/call. Choose this when you need only the seasonal color verdict and palette as JSON. For the fuller styling verdict (face impression, body frame, silhouette) use style_profile; for a finished PDF for a human client use style_report.

  Parameters:

  • style — string — One of: feminine, masculine, neutral. Styling context: feminine, masculine or neutral
  • images — array — up to 3 of {image_url|image_base64}; different lighting recommended
  • image_url — string — Absolute http(s) URL of the image (JPEG/PNG/WebP)
  • pack_code — string — retry credit issued after an unbilled failed call (replaces payment)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • image_base64 — string — Base64-encoded image bytes (alternative to image_url)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_payroll_net

  Annual gross salary to net take-home (social insurance + income tax + resident tax). Exact NTA Beppyo-5 table. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for a whole YEAR: annual gross salary to annual take-home after social insurance, income tax and resident tax. For one bonus use jp_bonus_net; for one month's premiums only use jp_social_insurance; to check an actual payslip use jp_payslip_audit.

  Parameters:

  • annual_gross_yen (required) — integer — Annual gross salary in yen
  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • year — integer — Calendar year
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • dependents — object — Dependents object (see /catalog input spec)
  • annual_bonus_yen — integer — Annual bonus total in yen

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_bonus_net

  Bonus net pay: social insurance and withholding tax (official rate table, based on previous month salary). $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for ONE bonus payment: its social insurance and withholding tax (the tax rate depends on the previous month's salary after social insurance). For annual totals use jp_payroll_net.

  Parameters:

  • bonus_yen (required) — integer — Bonus amount in yen
  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • dependents — integer — Dependents object (see /catalog input spec)
  • ytd_bonus_yen — integer — Bonus paid so far in the fiscal year (health-insurance annual cap check)
  • previous_month_after_si_yen — integer — Previous month's pay after social insurance (withholding table lookup)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_social_insurance

  Monthly social insurance premiums from the official Kyokai-Kenpo grade table (FY2026). $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this when you only need the monthly social insurance premiums for a given monthly remuneration (official grade table); no tax is computed - for take-home pay use jp_payroll_net.

  Parameters:

  • monthly_remuneration_yen (required) — integer — Monthly remuneration in yen (grade table lookup)
  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_dependent_threshold

  Income-wall analysis: tax, social insurance (1.06M/1.30M), spousal and student-dependent walls. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this for 'how much can be earned before ...' questions: it locates the income walls (tax, social insurance, spousal, student dependent) for an annual income. It does not compute take-home pay (use jp_payroll_net).

  Parameters:

  • annual_income_yen (required) — integer — Expected annual income in yen
  • year — integer — Calendar year
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_consumption_tax

  Consumption tax: per-rate invoice rounding, qualified-invoice validation, simplified taxation, 20% special. $0.01/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default invoice_totals): invoice_totals -> lines; validate_invoice -> document; simplified -> taxable_sales_excl_yen, category; two_percent -> taxable_sales_excl_yen, taxable_period_start, taxable_period_end.

  Parameters:

  • mode — string — Required by mode (default invoice_totals): invoice_totals -> lines; validate_invoice -> document; simplified -> taxable_sales_excl_yen, category; two_percent -> taxable_sales_excl_yen, taxable_period_start, taxable_period_end.
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • lines — array — Invoice lines [{amount_yen, qty, rate_key: standard|reduced}]
  • category — string — Simplified-taxation business class 1-6
  • document — object — Qualified-invoice fields to validate (registration_number etc.)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • taxable_period_end — string — Taxable period last day YYYY-MM-DD (two_percent)
  • taxable_period_start — string — Taxable period first day YYYY-MM-DD (two_percent)
  • taxable_sales_excl_yen — integer — Taxable sales excluding tax, in yen

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_business_days

  Japanese holidays, business-day arithmetic, statutory filing deadlines with holiday shift, wareki conversion. $0.003/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default add): add -> from, days; between -> from, to; holidays -> year; deadline -> kind, base_date; wareki -> date.

  Parameters:

  • to — string — End date YYYY-MM-DD
  • date — string — Date YYYY-MM-DD
  • days — integer — Number of business days to add
  • from — string — Start date YYYY-MM-DD
  • kind — string — One of: withholding_tax_monthly, social_insurance_monthly, corporate_tax, consumption_tax_corporate, income_tax_final, consumption_tax_individual, depreciable_assets, legal_records. Statutory deadline kind (see enum)
  • mode — string — Required by mode (default add): add -> from, days; between -> from, to; holidays -> year; deadline -> kind, base_date; wareki -> date.
  • year — integer — Calendar year
  • base_date — string — Base date YYYY-MM-DD for deadline calculation
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • saturday_off — boolean — Treat Saturdays as non-business days (default true)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_overtime_wage

  Overtime premium pay (Labor Standards Act Art.37, official rounding notice) and Article-36 limit check. $0.015/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Required by mode (default pay): pay -> monthly_salary_yen, monthly_scheduled_hours, hours; check36 -> monthly_overtime_hours.

  Parameters:

  • mode — string — Required by mode (default pay): pay -> monthly_salary_yen, monthly_scheduled_hours, hours; check36 -> monthly_overtime_hours.
  • hours — object — Hours worked
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • monthly_salary_yen — integer — Monthly base salary in yen
  • monthly_overtime_hours — array — List of monthly overtime hours (36-agreement check)
  • monthly_scheduled_hours — number — Scheduled working hours per month

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_retirement_tax

  Retirement income tax: deduction by years of service, half-taxation rules, exact withholding rounding. $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed.

  Parameters:

  • payout_yen (required) — integer — Retirement allowance paid, in yen
  • years_of_service (required) — integer — Years of service (retirement income deduction)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • disability — boolean — True if retirement is due to disability (extra deduction)
  • is_officer — boolean — True for an officer/executive (short-service officer rules)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_mortgage

  Mortgage schedules (level payment/principal), total interest, prepayment effect. $0.005/call. Deterministic, cites primary sources; errors and unverified rules are never billed.

  Parameters:

  • principal_yen (required) — integer — Loan principal in yen
  • annual_rate (required) — number — Annual interest rate as a decimal, e.g. 0.01
  • months (required) — integer — Loan term in months
  • method — string — One of: level_payment, level_principal. Cost method: total_average or moving_average
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • prepayment — object — Optional prepayment {at_month, amount_yen, mode: reduce_term|reduce_payment}

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_payslip_audit

  Audit a Japanese payslip: recompute statutory premiums and withholding tax from official tables and diff against the actual amounts, with per-item verdicts (match/explainable/mismatch). $0.02/call. Deterministic, cites primary sources; errors and unverified rules are never billed. Choose this when you HAVE an actual payslip and want each deduction checked against the official tables (match/explainable/mismatch); to compute expected amounts from a salary alone use jp_payroll_net or jp_social_insurance.

  Parameters:

  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • payslip (required) — object — Payslip fields to audit - see /catalog input spec
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • standard_monthly_yen — integer — Standard monthly remuneration if known (else estimated from salary)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_crypto_tax

  Japan crypto-asset tax: realized income under the NTA total-average or moving-average method (sell/spend/exchange as disposals, fees deductible), verified against the official NTA FAQ examples. $0.05/call. Deterministic, cites primary sources; errors and unverified rules are never billed.

  Parameters:

  • transactions (required) — array — Crypto transactions list (max 300) - see /catalog input spec
  • year — integer — Calendar year
  • as_of — string — Calculation reference date YYYY-MM-DD (default today); selects the rules version
  • method — string — One of: total_average, moving_average. Cost method: total_average or moving_average
  • opening — array — Carried-over holdings [{asset, qty, cost_jpy}]
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • other_taxable_income_yen — integer — Other taxable income in yen (returns incremental income tax as reference)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• jp_payroll_suite

  Japan payroll suite: net salary + social insurance + income walls (+bonus) in one call. Flat $0.05. Choose this when you want take-home pay, social insurance and the income walls (and the bonus, if given) together from one annual figure in one call; if you only need the take-home amount, jp_payroll_net is cheaper.

  Parameters:

  • annual_gross_yen (required) — integer — Annual gross salary in yen
  • prefecture (required) — string — Prefecture (romaji or Japanese), e.g. 'Tokyo'
  • age — integer — Age in years (selects care-insurance and other age-gated rules)
  • x_payment — string — Optional: base64 X-PAYMENT header value (x402 exact scheme, USDC on Base mainnet). Omit it to receive the payment requirements (accepts[] + docs) for this call without being charged.
  • dependents — object — Dependents object (see /catalog input spec)
  • annual_bonus_yen — integer — Annual bonus total in yen
  • previous_month_after_si_yen — integer — Previous month's pay after social insurance (withholding table lookup)

  Hints: read-only no · destructive no · idempotent yes · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.