MCP MeasureMCP Measure

index observed

Japan Corporate Number and Certifications (gBizINFO)

Which Japanese corporate numbers match this company name? gBizINFO (METI) relay with sources.

Should I use this

Quality & Safety

A
Description quality
96%
Schema completeness
86%
Naming quality
80%
Poisoning risk
80%
Permission match
100%
Protocol compliance
100%

Findings (4)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool 'gbizinfo_certifications' description contains placeholder textin gbizinfo_certifications
  • LOWTool 'gbizinfo_resolve_corporate_number' name length outside 3-30 rangein gbizinfo_resolve_corporate_number
  • INFOTool description contains placeholder or incomplete textin gbizinfo_certifications

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~4,726Tokens (tool definitions)
~10.9 KBTypical response size
Significant attention impact (3.69% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "jp-gbizinfo": {
      "url": "https://jp-gbizinfo-production.mk-career-planning.workers.dev/mcp"
    }
  }
}

Remote endpoints

https://jp-gbizinfo-production.mk-career-planning.workers.dev/mcpstreamable-http

What it can do

Tool inventory

Tools (5)

🟒 Read-only🟑 WriteπŸ”΄ Deleteβšͺ Unknown
🟒catalog

List the tools of this server with prices, data sources, licensing, daily limits and data freshness.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "server": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "version": {
          "type": "string"
        },
        "stage": {
          "type": "string"
        }
      },
      "required": [
        "name",
        "version",
        "stage"
      ],
      "additionalProperties": {}
    },
    "payment": {
      "type": "object",
      "properties": {
        "protocol": {
          "type": "string"
        },
        "network": {
          "type": "string"
        },
        "asset": {
          "type": "string"
        },
        "enabled": {
          "type": "boolean"
        }
      },
      "required": [
        "protocol",
        "network",
        "asset",
        "enabled"
      ],
      "additionalProperties": {}
    },
    "daily_limits": {
      "type": "object",
      "properties": {},
      "additionalProperties": {},
      "description": "Daily limits of paid calls (calls, usd, timezone) or a misconfiguration notice."
    },
    "paused": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "boolean"
      },
      "description": "Operator pause flags (true = paused)."
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "price_usd": {
            "type": "number",
            "description": "Price per call in USD (0 = free)."
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "price_usd",
          "description"
        ],
        "additionalProperties": {}
      },
      "description": "Every tool of this server with its price."
    },
    "legal": {
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "fetch_status_values": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "server",
    "payment",
    "daily_limits",
    "paused",
    "tools",
    "legal",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟒gbizinfo_resolve_corporate_number(name, prefecture, address_hint, limit)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 100,
      "description": "Company name in Japanese or English, 2-100 characters, e.g. η΅ŒζΈˆη”£ζ₯­ηœ or a company name. gBizINFO matches it as a partial name."
    },
    "prefecture": {
      "description": "Optional prefecture code 01-47 (e.g. 13) or name (Tokyo or 東京都) to narrow the search to head offices in that prefecture.",
      "type": "string",
      "maxLength": 20
    },
    "address_hint": {
      "description": "Optional part of the address (e.g. εƒδ»£η”°εŒΊιœžγŒι–’). Candidates whose published address contains it are listed first; no candidate is dropped.",
      "type": "string",
      "maxLength": 100
    },
    "limit": {
      "description": "Number of candidates to detail, 1-50 (default 20). candidate_corporate_numbers always lists all of them (up to 200).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "attribution": {
      "type": "object",
      "properties": {
        "notice_ja": {
          "type": "string"
        },
        "notice_en": {
          "type": "string"
        },
        "retrieved_on": {
          "type": [
            "string",
            "null"
          ]
        },
        "notice_ja_with_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "not_official_ja": {
          "type": "string"
        },
        "not_official_en": {
          "type": "string"
        },
        "source_url": {
          "type": "string"
        },
        "terms_url": {
          "type": "string"
        },
        "processed_by": {
          "type": "string"
        }
      },
      "required": [
        "notice_ja",
        "notice_en",
        "retrieved_on",
        "notice_ja_with_date",
        "not_official_ja",
        "not_official_en",
        "source_url",
        "terms_url",
        "processed_by"
      ],
      "additionalProperties": {},
      "description": "Required source notice (gBizINFO terms of use; notice_ja is the required wording, notice_ja_with_date adds the retrieval date) and the statement that this is processed by MK Career Planning and is not an official government result. Keep it when you pass results on."
    },
    "legal_notice": {
      "type": "string"
    },
    "query": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "prefecture": {
          "type": [
            "string",
            "null"
          ]
        },
        "address_hint": {
          "type": [
            "string",
            "null"
          ]
        },
        "limit": {
          "type": "number"
        }
      },
      "required": [
        "name",
        "prefecture",
        "address_hint",
        "limit"
      ],
      "additionalProperties": {}
    },
    "status": {
      "type": "string",
      "enum": [
        "candidates_found",
        "no_candidates_found",
        "unknown"
      ],
      "description": "candidates_found / no_candidates_found / unknown (see unknown_reason). A failure is never reported as no candidates."
    },
    "unknown_reason": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "api_key_missing",
            "rate_capped",
            "upstream_error"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "total": {
      "description": "Number of candidates gBizINFO returned (a lower bound when total_is_lower_bound).",
      "type": [
        "number",
        "null"
      ]
    },
    "total_is_lower_bound": {
      "type": "boolean"
    },
    "returned": {
      "type": "number"
    },
    "truncated": {
      "type": "boolean"
    },
    "exact_name_matches": {
      "type": "number"
    },
    "candidate_corporate_numbers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Every candidate's corporate number, including those not detailed in candidates (never collapsed to one)."
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "corporate_number": {
            "type": "string"
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "location": {
            "type": [
              "string",
              "null"
            ]
          },
          "match_basis": {
            "type": "string",
            "enum": [
              "exact_name",
              "fuzzy_candidate"
            ]
          },
          "address_hint_matches": {
            "type": [
              "boolean",
              "null"
            ]
          },
          "gbizinfo_page_url": {
            "type": "string"
          }
        },
        "required": [
          "corporate_number",
          "name",
          "location",
          "match_basis",
          "address_hint_matches",
          "gbizinfo_page_url"
        ],
        "additionalProperties": {}
      }
    },
    "status_as_of": {
      "type": [
        "string",
        "null"
      ]
    },
    "retrieved_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "answered_at": {
      "type": "string"
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "attribution",
    "legal_notice",
    "query",
    "status",
    "unknown_reason",
    "total",
    "total_is_lower_bound",
    "returned",
    "truncated",
    "exact_name_matches",
    "candidate_corporate_numbers",
    "candidates",
    "status_as_of",
    "retrieved_at",
    "answered_at",
    "limitations",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟒gbizinfo_company_basic(corporate_number)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "corporate_number": {
      "type": "string",
      "maxLength": 20,
      "description": "13-digit Japanese corporate number (houjin bangou), e.g. 4000012090001. The check digit is verified; nothing is requested for an invalid number."
    }
  },
  "required": [
    "corporate_number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "attribution": {
      "type": "object",
      "properties": {
        "notice_ja": {
          "type": "string"
        },
        "notice_en": {
          "type": "string"
        },
        "retrieved_on": {
          "type": [
            "string",
            "null"
          ]
        },
        "notice_ja_with_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "not_official_ja": {
          "type": "string"
        },
        "not_official_en": {
          "type": "string"
        },
        "source_url": {
          "type": "string"
        },
        "terms_url": {
          "type": "string"
        },
        "processed_by": {
          "type": "string"
        }
      },
      "required": [
        "notice_ja",
        "notice_en",
        "retrieved_on",
        "notice_ja_with_date",
        "not_official_ja",
        "not_official_en",
        "source_url",
        "terms_url",
        "processed_by"
      ],
      "additionalProperties": {},
      "description": "Required source notice (gBizINFO terms of use; notice_ja is the required wording, notice_ja_with_date adds the retrieval date) and the statement that this is processed by MK Career Planning and is not an official government result. Keep it when you pass results on."
    },
    "legal_notice": {
      "type": "string"
    },
    "query": {
      "type": "object",
      "properties": {
        "corporate_number": {
          "type": "string"
        }
      },
      "required": [
        "corporate_number"
      ],
      "additionalProperties": {}
    },
    "registry": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "listed",
        "not_found_in_checked_records",
        "no_longer_listed_since",
        "expired",
        "unknown"
      ]
    },
    "unknown_reason": {
      "type": [
        "string",
        "null"
      ]
    },
    "status_as_of": {
      "description": "gBizINFO's last_acquisition_date (when gBizINFO last took the item from its source), as published.",
      "type": [
        "string",
        "null"
      ]
    },
    "last_observed_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "source_url": {
      "type": "string"
    },
    "matched_records": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {},
        "additionalProperties": {}
      }
    },
    "match_basis": {
      "type": "string",
      "enum": [
        "exact_id",
        "exact_name",
        "fuzzy_candidate",
        "none"
      ]
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "record": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "corporate_number": {
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "location": {
              "type": [
                "string",
                "null"
              ]
            },
            "close_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "close_cause": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "corporate_number",
            "name",
            "location",
            "close_date",
            "close_cause"
          ],
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "record_state": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "closure_recorded",
            "no_closure_recorded"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "closure": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "recorded": {
              "type": "boolean"
            },
            "close_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "close_cause": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "recorded",
            "close_date",
            "close_cause"
          ],
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "retrieved_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "answered_at": {
      "type": "string"
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "attribution",
    "legal_notice",
    "query",
    "registry",
    "status",
    "unknown_reason",
    "status_as_of",
    "last_observed_at",
    "source_url",
    "matched_records",
    "match_basis",
    "limitations",
    "record",
    "record_state",
    "closure",
    "retrieved_at",
    "answered_at",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟒gbizinfo_certifications(corporate_number, ministry, limit)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "corporate_number": {
      "type": "string",
      "maxLength": 20,
      "description": "13-digit Japanese corporate number (houjin bangou), e.g. 4000012090001. The check digit is verified; nothing is requested for an invalid number."
    },
    "ministry": {
      "description": "Optional filter on the ministry as published (government_departments), e.g. ι‡‘θžεΊ for the Financial Services Agency.",
      "type": "string",
      "maxLength": 50
    },
    "limit": {
      "description": "Number of rows to return, 1-100 (default 100). total and truncated tell how many matched.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "corporate_number"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "attribution": {
      "type": "object",
      "properties": {
        "notice_ja": {
          "type": "string"
        },
        "notice_en": {
          "type": "string"
        },
        "retrieved_on": {
          "type": [
            "string",
            "null"
          ]
        },
        "notice_ja_with_date": {
          "type": [
            "string",
            "null"
          ]
        },
        "not_official_ja": {
          "type": "string"
        },
        "not_official_en": {
          "type": "string"
        },
        "source_url": {
          "type": "string"
        },
        "terms_url": {
          "type": "string"
        },
        "processed_by": {
          "type": "string"
        }
      },
      "required": [
        "notice_ja",
        "notice_en",
        "retrieved_on",
        "notice_ja_with_date",
        "not_official_ja",
        "not_official_en",
        "source_url",
        "terms_url",
        "processed_by"
      ],
      "additionalProperties": {},
      "description": "Required source notice (gBizINFO terms of use; notice_ja is the required wording, notice_ja_with_date adds the retrieval date) and the statement that this is processed by MK Career Planning and is not an official government result. Keep it when you pass results on."
    },
    "legal_notice": {
      "type": "string"
    },
    "query": {
      "type": "object",
      "properties": {
        "corporate_number": {
          "type": "string"
        },
        "ministry": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "corporate_number",
        "ministry"
      ],
      "additionalProperties": {}
    },
    "registry": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "listed",
        "not_found_in_checked_records",
        "no_longer_listed_since",
        "expired",
        "unknown"
      ]
    },
    "unknown_reason": {
      "type": [
        "string",
        "null"
      ]
    },
    "status_as_of": {
      "description": "gBizINFO's last_acquisition_date (when gBizINFO last took the item from its source), as published.",
      "type": [
        "string",
        "null"
      ]
    },
    "last_observed_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "source_url": {
      "type": "string"
    },
    "matched_records": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {},
        "additionalProperties": {}
      }
    },
    "match_basis": {
      "type": "string",
      "enum": [
        "exact_id",
        "exact_name",
        "fuzzy_candidate",
        "none"
      ]
    },
    "limitations": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "company": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "name": {
              "type": [
                "string",
                "null"
              ]
            },
            "location": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "required": [
            "name",
            "location"
          ],
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "total": {
      "type": [
        "number",
        "null"
      ]
    },
    "returned": {
      "type": "number"
    },
    "truncated": {
      "type": "boolean"
    },
    "retrieved_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "answered_at": {
      "type": "string"
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "attribution",
    "legal_notice",
    "query",
    "registry",
    "status",
    "unknown_reason",
    "status_as_of",
    "last_observed_at",
    "source_url",
    "matched_records",
    "match_basis",
    "limitations",
    "company",
    "total",
    "returned",
    "truncated",
    "retrieved_at",
    "answered_at",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟒get_receipt(receipt_id)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "receipt_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "The receipt_id returned with a paid result (\"rcpt_\" + 64 hex characters)."
    }
  },
  "required": [
    "receipt_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "receipt_id": {
      "type": "string",
      "description": "Receipt id of the settled paid call (\"rcpt_\" + 64 hex). Use with get_receipt."
    },
    "tool": {
      "type": "string",
      "description": "Name of the paid tool that produced the result."
    },
    "settled_at": {
      "type": [
        "string",
        "null"
      ]
    },
    "payment": {
      "type": "object",
      "properties": {
        "network": {
          "type": [
            "string",
            "null"
          ]
        },
        "transaction": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "network",
        "transaction"
      ],
      "additionalProperties": {}
    },
    "result": {
      "description": "The stored result, exactly as returned by the paid call."
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "source": {
            "type": "object",
            "properties": {
              "publisher": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "publisher",
              "url"
            ],
            "additionalProperties": {},
            "description": "Publisher and URL of the upstream document or dataset."
          },
          "upstream_updated_at": {
            "description": "Update time stated by the upstream, or null when it states none.",
            "type": [
              "string",
              "null"
            ]
          },
          "retrieved_at": {
            "description": "When this service retrieved the upstream data (null if unknown).",
            "type": [
              "string",
              "null"
            ]
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "fetch_status": {
            "type": "string",
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          }
        },
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "additionalProperties": {},
        "description": "Freshness receipt for one upstream source."
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    }
  },
  "required": [
    "receipt_id",
    "tool",
    "settled_at",
    "payment",
    "result",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded5 tools