# JP Business Opportunity Data Gateway (Closed Private Beta)

> Unlike generic news feeds or human-oriented portals, this gateway provides raw, deadline-driven Japanese public-sector business opportunity logs (open tender notices, subsidy programs, and procurement sanction lists) for autonomous agents.

This service is machine-to-machine only. Human/browser UX is intentionally not provided.
All /v1/* data endpoints are metered with the x402 protocol
(HTTP 402 + X-402-Payment-Required header, 0.05 USDC per call).

## Interface
- https://jp-biz-opportunity-62ko7b2uwa-an.a.run.app/openapi.yaml : OpenAPI 3.0.3 contract (paths, schemas, x402 flow)
- https://jp-biz-opportunity-62ko7b2uwa-an.a.run.app/sitemap.xml  : indexable JSON-LD dataset metadata pages

## MCP (Model Context Protocol)
- https://jp-biz-opportunity-62ko7b2uwa-an.a.run.app/mcp : remote MCP server (Streamable HTTP, stateless). Tools:
  list_opportunity_datasets, search_open_tenders, get_tender_notice,
  search_subsidies, get_subsidy_program, search_sanctions.
  Paid tools return x402 payment challenges.

## Paid data endpoints (x402)
- /v1/tenders/search?keyword=&region=&deadline_within_days= : open tender notice search (入札公告)
- /v1/tenders/{tender_id} : full tender notice raw record (T-2026-NNNN)
- /v1/subsidies/search?keyword=&industry=&deadline_within_days= : subsidy / grant program search (補助金・助成金)
- /v1/subsidies/{subsidy_id} : full subsidy program raw record (S-2026-NNNN)
- /v1/sanctions/search?corporate_id= : suspension / administrative sanction lookup by 13-digit corporate number (指名停止・行政処分)