# jp-gbizinfo

> Which Japanese corporate numbers match this company name, and what does gBizINFO (METI) publish for one? Hosted MCP and HTTP: no install. Corporate number candidates from gBizINFO's name search (all candidates, never collapsed to one), basic information (name, address, closure date and cause) and notifications and certifications published by ministries, with the gBizINFO source notice, retrieval date and a freshness receipt. Free. Not an official government result.

Data source: gBizINFO (Ministry of Economy, Trade and Industry of Japan, METI), https://info.gbiz.go.jp/ (REST API v2: https://api.info.gbiz.go.jp/hojin/swagger-ui/index.html?urls.primaryName=v2 , https://api.info.gbiz.go.jp/hojin/v3/api-docs/v2; terms of use: https://help.info.gbiz.go.jp/hc/ja/articles/4795140981406; API terms: https://help.info.gbiz.go.jp/hc/ja/articles/4999421139102). Required source notice: 出典：「Gビズインフォ」（経済産業省）（https://info.gbiz.go.jp/）を加工して作成 (English: Source: "gBizINFO" (Ministry of Economy, Trade and Industry of Japan) (https://info.gbiz.go.jp/), processed by MK Career Planning.) Each answer adds the retrieval date. This answer was produced by MK Career Planning by processing information published by gBizINFO. It is not an official result of the Ministry of Economy, Trade and Industry or the Government of Japan.
Information published by gBizINFO (METI), relayed and processed by MK Career Planning. Not an official result of METI or the Government of Japan, and not a decision on whether to trade with, lend to or contract with any party. gBizINFO does not hold every ministry's information, so a missing row is not evidence that something does not exist.
gbizinfo_resolve_corporate_number: status candidates_found, no_candidates_found or unknown. Every candidate's corporate number is returned (candidate_corporate_numbers); match_basis exact_name or fuzzy_candidate. Neither is an identity match, and the service never chooses one.
gbizinfo_company_basic: listed (record_state closure_recorded only when the record states a closure date), not_found_in_checked_records, or unknown. gbizinfo_certifications: listed with rows as published, or unknown; zero rows is unknown with unknown_reason source_not_exhaustive, because gBizINFO does not hold every ministry's information.
unknown_reason api_key_missing, rate_capped (this service caps its own calls to gBizINFO; ask again later) or upstream_error never means none. status_as_of is gBizINFO's last_acquisition_date.
Not returned: representative names, workplace information, patents, subsidies, procurement and awards.
Answers are fetched from gBizINFO on demand and cached for up to 1 day.

## Connect

- MCP (streamable HTTP): https://jp-gbizinfo-production.mk-career-planning.workers.dev/mcp
- OpenAPI: https://jp-gbizinfo-production.mk-career-planning.workers.dev/openapi.json
- x402 discovery: https://jp-gbizinfo-production.mk-career-planning.workers.dev/.well-known/x402

## Quickstart

- Developer quickstart (MCP client configs, free curl/TypeScript calls, how to read candidates, status, unknown_reason and the required gBizINFO source notice): https://jp-gbizinfo-production.mk-career-planning.workers.dev/quickstart

## Free tools

- catalog: List the tools of this server with prices, data sources, licensing, daily limits and data freshness.
- gbizinfo_resolve_corporate_number: Which Japanese corporate numbers could this company name refer to? Searches gBizINFO (METI) by name (partial match), optionally within a prefecture, and returns every candidate with corporate number, name and address, marked exact_name or fuzzy_candidate. Never picks one for you: all candidate numbers are returned with total and truncated. Carries the gBizINFO source notice. Not an official result.
- gbizinfo_company_basic: What does gBizINFO (METI) publish as basic information for this Japanese corporate number? Returns the name, kana, English name, address and the closure date and cause when the record states them (from the National Tax Agency source as relayed by gBizINFO), with gBizINFO's last_acquisition_date as status_as_of. Representative names are not returned. Carries the gBizINFO source notice. Not an official result.
- gbizinfo_certifications: Which notifications and certifications (todokede / nintei, e.g. FSA registrations) does gBizINFO (METI) publish for this Japanese corporate number? Returns the rows as published with ministry, title and date. Zero rows is unknown (source_not_exhaustive), never none: gBizINFO does not hold every ministry's information. Carries the gBizINFO source notice. Not an official result.
- get_receipt: Re-fetch the stored result of a settled paid call by its receipt_id, for when the response was lost after payment. Free. Unknown or unsettled receipt ids return RECEIPT_NOT_FOUND. Results are kept for 90 days after settlement.
- HTTP: GET https://jp-gbizinfo-production.mk-career-planning.workers.dev/v1/gbizinfo/resolve, GET https://jp-gbizinfo-production.mk-career-planning.workers.dev/v1/gbizinfo/basic, GET https://jp-gbizinfo-production.mk-career-planning.workers.dev/v1/gbizinfo/certifications return the same data as the MCP tools. GET https://jp-gbizinfo-production.mk-career-planning.workers.dev/v1/receipts/<receipt_id> is get_receipt.

## Payments

This server offers free tools only. It does not request or accept x402 payments.

## Rate limits

- Free calls (free HTTP endpoints under /v1/ and free MCP tools) are limited to 300 requests per 60 seconds per client (a client is keyed by a one-way hash of its IP address and the first 64 characters of its User-Agent; neither is stored. The User-Agent can be set by anyone, so this split is for fairness between clients behind a shared gateway, not a security control). Over the limit, HTTP returns 429 RATE_LIMITED with a Retry-After header and MCP tools return the error RATE_LIMITED. Paid calls are not rate limited.

## Provenance and fetch_status

Responses carry provenance[] (source, upstream_updated_at, retrieved_at, content_sha256, parser_version, fetch_status). fetch_status values:

- found: The upstream document was retrieved and contains the data used for this answer.
- empty: The upstream was retrieved, but it has no item for this query (for example JMA had no bulletin for that area in its feeds, or the municipality is not in the list). The state is unknown: empty does NOT mean 'none in effect'.
- stale: The data was retrieved but is older than the freshness threshold for its kind; treat it with care.
- unavailable: The upstream could not be retrieved, read or used (network error, withdrawn bulletin, paused source, or data not yet loaded).
- unsupported: The query is outside what this source covers (for example a date JMA does not issue warnings for yet, or a period before the source's records).

## Errors

- RECEIPT_NOT_FOUND (get_receipt)
- RATE_LIMITED (free calls over the per-client limit; HTTP 429 with Retry-After; not charged)

## Terms

- Keep the attribution (notice_ja with the retrieval date, and the statement that it is processed by MK Career Planning and not an official result) when you pass results on.
- Not a decision on whether to trade with, lend to or contract with any party.

## Privacy and support

- Operator: MK Career Planning
- Terms of Service: https://jp-gbizinfo-production.mk-career-planning.workers.dev/terms
- Privacy policy: https://jp-gbizinfo-production.mk-career-planning.workers.dev/privacy
- Support (free): https://jp-gbizinfo-production.mk-career-planning.workers.dev/support (mk.career.planning@gmail.com)