Japan Qualified Invoice Issuers (Corporations)

Japan NTA qualified invoice issuer status of corporations by T-number. Records daily changes.

Should I use this

Quality & Safety

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

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~4,871Tokens (tool definitions)
~15.1 KBTypical response size
Significant attention impact (3.81% 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-invoice-registry": {
      "url": "https://jp-invoice-registry-production.mk-career-planning.workers.dev/mcp"
    }
  }
}

Remote endpoints

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

What it can do

Tool inventory

Tools (4)

🟢 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": {}
}
🟢invoice_registration_lookup(number, corporate_number)

Is this Japanese corporation a registered qualified invoice issuer, since when, and was it cancelled or did it expire? Give number (T1000020109142) or corporate_number (13 digits); the check digit is validated. Returns listed, expired (cancellation or expiry date passed) or unknown, with NTA's published dates, the difference file used, fetched_at and recorded changes. Corporations only. A number not seen in the recorded files is unknown, never 'not registered'.

Input Schema

{
  "type": "object",
  "properties": {
    "number": {
      "description": "Registration number: T followed by 13 digits, e.g. T1000020109142 (width, spaces and hyphens ignored)",
      "type": "string",
      "maxLength": 40
    },
    "corporate_number": {
      "description": "Corporate number (houjin bangou), 13 digits, e.g. 1000020109142; looked up as T + the 13 digits",
      "type": "string",
      "maxLength": 40
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "official_check": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string"
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "message",
        "urls"
      ],
      "additionalProperties": {},
      "description": "Read first: as published by NTA; check the official site listed here before relying on this answer."
    },
    "query": {
      "type": "object",
      "properties": {
        "registration_number": {
          "type": "string"
        }
      },
      "required": [
        "registration_number"
      ],
      "additionalProperties": {}
    },
    "status": {
      "type": "string",
      "enum": [
        "listed",
        "expired",
        "unknown"
      ],
      "description": "listed = the latest recorded record shows a registration; expired = it shows a cancellation or expiry date that has passed; unknown = not in the changes recorded since tracking_since while the full file is not loaded (not_in_recorded_changes_full_file_not_loaded; never means not registered), or data not loaded, stale, still loading, or a gap."
    },
    "status_note": {
      "type": "string"
    },
    "unknown_reason": {
      "type": [
        "string",
        "null"
      ]
    },
    "registration": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "registration_number": {
              "type": "string",
              "description": "T followed by 13 digits, as published."
            },
            "corporate_number": {
              "description": "The 13 digits for a corporation (combine with jp-entity-evidence or jp-gbizinfo).",
              "type": [
                "string",
                "null"
              ]
            },
            "name": {
              "type": "string",
              "description": "Name as published by NTA."
            },
            "head_office_address": {
              "type": [
                "string",
                "null"
              ]
            },
            "registration_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "cancellation_date": {
              "description": "Cancellation date (torikeshi) as published, YYYY-MM-DD.",
              "type": [
                "string",
                "null"
              ]
            },
            "expiry_date": {
              "description": "Expiry date (shikko) as published, YYYY-MM-DD.",
              "type": [
                "string",
                "null"
              ]
            },
            "registration_status": {
              "type": "string",
              "enum": [
                "registered",
                "registration_scheduled",
                "cancellation_scheduled",
                "expiry_scheduled",
                "cancelled",
                "expired"
              ],
              "description": "Computed from the published dates against today (Japan time)."
            },
            "registration_status_date": {
              "type": [
                "string",
                "null"
              ]
            },
            "status_statement": {
              "type": "string"
            },
            "first_seen_file_date": {
              "type": "string"
            },
            "last_change_file_date": {
              "type": "string"
            },
            "source": {
              "type": "object",
              "properties": {
                "file_date": {
                  "type": "string"
                },
                "file_url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "fetched_at": {
                  "type": "string"
                },
                "list_url": {
                  "type": "string"
                }
              },
              "required": [
                "file_date",
                "file_url",
                "fetched_at",
                "list_url"
              ],
              "additionalProperties": {}
            }
          },
          "required": [
            "registration_number",
            "corporate_number",
            "name",
            "head_office_address",
            "registration_date",
            "cancellation_date",
            "expiry_date",
            "registration_status",
            "registration_status_date",
            "status_statement",
            "first_seen_file_date",
            "last_change_file_date",
            "source"
          ],
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "recorded_changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "file_date": {
            "type": "string",
            "description": "Creation date of the NTA difference file."
          },
          "file_key": {
            "type": "string"
          },
          "observed_at": {
            "type": "string",
            "description": "When this service read the file."
          },
          "registration_number": {
            "type": "string"
          },
          "event_type": {
            "type": "string",
            "enum": [
              "registered",
              "details_changed",
              "expired",
              "cancelled",
              "record_deleted",
              "past_record"
            ]
          },
          "statement": {
            "type": "string"
          },
          "process": {
            "type": "string"
          },
          "registration_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "cancellation_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "expiry_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "record": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "registration_number": {
                    "type": "string",
                    "description": "T followed by 13 digits, as published."
                  },
                  "corporate_number": {
                    "description": "The 13 digits for a corporation (combine with jp-entity-evidence or jp-gbizinfo).",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "name": {
                    "type": "string",
                    "description": "Name as published by NTA."
                  },
                  "head_office_address": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "registration_date": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cancellation_date": {
                    "description": "Cancellation date (torikeshi) as published, YYYY-MM-DD.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "expiry_date": {
                    "description": "Expiry date (shikko) as published, YYYY-MM-DD.",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "registration_number",
                  "corporate_number",
                  "name",
                  "head_office_address",
                  "registration_date",
                  "cancellation_date",
                  "expiry_date"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "file_date",
          "file_key",
          "observed_at",
          "registration_number",
          "event_type",
          "statement",
          "process",
          "registration_date",
          "cancellation_date",
          "expiry_date",
          "record"
        ],
        "additionalProperties": {}
      }
    },
    "registry_status": {
      "type": "object",
      "properties": {
        "registry": {
          "type": "string"
        },
        "registry_name_en": {
          "type": "string"
        },
        "registry_name_ja": {
          "type": "string"
        },
        "authority": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "listed",
            "not_found_in_checked_records",
            "no_longer_listed_since",
            "expired",
            "unknown"
          ],
          "description": "listed: A record matching the query by identifier or exact name is in the version of the official record checked (status_as_of). not_found_in_checked_records: No matching record in the version checked. It says nothing about other registries, other names or periods before tracking_since. no_longer_listed_since: A matching record was seen by this service earlier and is not in the current version since the date given. The reason is not published here and is not inferred. expired: The official record itself states an end or expiry date that has passed. The reason is not inferred. unknown: Could not be determined: not checked, data unavailable or stale, or only similar-name candidates were found (see unknown_reason)."
        },
        "unknown_reason": {
          "type": [
            "string",
            "null"
          ]
        },
        "status_since": {
          "type": [
            "string",
            "null"
          ]
        },
        "status_as_of": {
          "type": [
            "string",
            "null"
          ]
        },
        "last_observed_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "tracking_since": {
          "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"
          }
        }
      },
      "required": [
        "registry",
        "registry_name_en",
        "registry_name_ja",
        "authority",
        "status",
        "unknown_reason",
        "status_since",
        "status_as_of",
        "last_observed_at",
        "tracking_since",
        "source_url",
        "matched_records",
        "match_basis",
        "limitations"
      ],
      "additionalProperties": {}
    },
    "data_version": {
      "type": "object",
      "properties": {
        "tracking_since": {
          "type": [
            "string",
            "null"
          ]
        },
        "full_file_loaded": {
          "type": "boolean"
        },
        "gaps": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {},
            "additionalProperties": {}
          }
        }
      },
      "required": [
        "tracking_since",
        "full_file_loaded",
        "gaps"
      ],
      "additionalProperties": {}
    },
    "nta_notice": {
      "type": "object",
      "properties": {
        "en": {
          "type": "string"
        },
        "ja": {
          "type": "string"
        }
      },
      "required": [
        "en",
        "ja"
      ],
      "additionalProperties": {},
      "description": "Always pass on: cancellation and expiry are published facts with the dates as published, not an assessment of the business."
    },
    "legal_notice": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "properties": {
        "source_ja": {
          "type": "string"
        },
        "processed_ja": {
          "type": "string"
        },
        "source_en": {
          "type": "string"
        },
        "terms_url": {
          "type": "string"
        },
        "license_url": {
          "type": "string"
        },
        "license_note": {
          "type": "string"
        }
      },
      "required": [
        "source_ja",
        "processed_ja",
        "source_en",
        "terms_url",
        "license_url",
        "license_note"
      ],
      "additionalProperties": {}
    },
    "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": [
    "official_check",
    "query",
    "status",
    "status_note",
    "unknown_reason",
    "registration",
    "recorded_changes",
    "registry_status",
    "data_version",
    "nta_notice",
    "legal_notice",
    "attribution",
    "answered_at",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢invoice_registration_changes(since, event_type, limit, cursor)

Which Japanese corporations were newly registered as qualified invoice issuers, had their published details changed, or had their registration cancelled or expired, in NTA's daily difference files since a date? From this service's own record of the files it read (NTA keeps them 40 business days). Each change has the file date, observed_at, the event type and the dates as published. Corporations only. Free window: last 30 days; page with next_cursor.

Input Schema

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "maxLength": 40,
      "description": "ISO 8601 date or date-time with time zone, e.g. 2026-10-01; changes in difference files created on or after that date"
    },
    "event_type": {
      "description": "Optional filter: registered, details_changed, expired, cancelled, record_deleted or past_record",
      "type": "string",
      "enum": [
        "registered",
        "details_changed",
        "expired",
        "cancelled",
        "record_deleted",
        "past_record"
      ]
    },
    "limit": {
      "description": "Maximum number of changes, 1-500 (default 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "cursor": {
      "description": "next_cursor from a previous answer, to read the next page",
      "type": "string",
      "maxLength": 40
    }
  },
  "required": [
    "since"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output Schema

{
  "type": "object",
  "properties": {
    "official_check": {
      "type": "object",
      "properties": {
        "message": {
          "type": "string"
        },
        "urls": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "message",
        "urls"
      ],
      "additionalProperties": {},
      "description": "Read first: as published by NTA; check the official site listed here before relying on this answer."
    },
    "query": {
      "type": "object",
      "properties": {
        "since": {
          "type": "string"
        },
        "since_file_date": {
          "type": "string"
        }
      },
      "required": [
        "since",
        "since_file_date"
      ],
      "additionalProperties": {}
    },
    "tracking_since": {
      "description": "Date of the first NTA difference file this service read. Nothing before it was observed.",
      "type": [
        "string",
        "null"
      ]
    },
    "history_window": {
      "type": "object",
      "properties": {
        "free_days": {
          "type": "number",
          "description": "Days of recorded history served free of charge."
        },
        "requested_since": {
          "type": "string",
          "description": "The since you asked for (normalized to ISO 8601)."
        },
        "served_since": {
          "type": "string",
          "description": "The since actually applied: requested_since, or the start of the free window if requested_since was earlier."
        },
        "clamped": {
          "type": "boolean",
          "description": "true when requested_since was earlier than the free window and the answer covers only the window."
        },
        "older_history": {
          "type": "string",
          "description": "Status of recorded history older than the free window."
        }
      },
      "required": [
        "free_days",
        "requested_since",
        "served_since",
        "clamped",
        "older_history"
      ],
      "additionalProperties": {},
      "description": "Free history window applied to this answer."
    },
    "coverage": {
      "type": "object",
      "properties": {
        "since_before_tracking": {
          "type": "boolean"
        },
        "note": {
          "type": "string"
        }
      },
      "required": [
        "since_before_tracking",
        "note"
      ],
      "additionalProperties": {}
    },
    "files_observed": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "file_date": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "required": [
          "file_date",
          "status"
        ],
        "additionalProperties": {}
      }
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "file_date": {
            "type": "string",
            "description": "Creation date of the NTA difference file."
          },
          "file_key": {
            "type": "string"
          },
          "observed_at": {
            "type": "string",
            "description": "When this service read the file."
          },
          "registration_number": {
            "type": "string"
          },
          "event_type": {
            "type": "string",
            "enum": [
              "registered",
              "details_changed",
              "expired",
              "cancelled",
              "record_deleted",
              "past_record"
            ]
          },
          "statement": {
            "type": "string"
          },
          "process": {
            "type": "string"
          },
          "registration_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "cancellation_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "expiry_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "record": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "registration_number": {
                    "type": "string",
                    "description": "T followed by 13 digits, as published."
                  },
                  "corporate_number": {
                    "description": "The 13 digits for a corporation (combine with jp-entity-evidence or jp-gbizinfo).",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "name": {
                    "type": "string",
                    "description": "Name as published by NTA."
                  },
                  "head_office_address": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "registration_date": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "cancellation_date": {
                    "description": "Cancellation date (torikeshi) as published, YYYY-MM-DD.",
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "expiry_date": {
                    "description": "Expiry date (shikko) as published, YYYY-MM-DD.",
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "registration_number",
                  "corporate_number",
                  "name",
                  "head_office_address",
                  "registration_date",
                  "cancellation_date",
                  "expiry_date"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "file_date",
          "file_key",
          "observed_at",
          "registration_number",
          "event_type",
          "statement",
          "process",
          "registration_date",
          "cancellation_date",
          "expiry_date",
          "record"
        ],
        "additionalProperties": {}
      },
      "description": "Corporate rows of the NTA difference files read by this service, oldest first."
    },
    "truncated": {
      "type": "boolean"
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ]
    },
    "nta_notice": {
      "type": "object",
      "properties": {
        "en": {
          "type": "string"
        },
        "ja": {
          "type": "string"
        }
      },
      "required": [
        "en",
        "ja"
      ],
      "additionalProperties": {},
      "description": "Always pass on: cancellation and expiry are published facts with the dates as published, not an assessment of the business."
    },
    "legal_notice": {
      "type": "string"
    },
    "history_note": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "properties": {
        "source_ja": {
          "type": "string"
        },
        "processed_ja": {
          "type": "string"
        },
        "source_en": {
          "type": "string"
        },
        "terms_url": {
          "type": "string"
        },
        "license_url": {
          "type": "string"
        },
        "license_note": {
          "type": "string"
        }
      },
      "required": [
        "source_ja",
        "processed_ja",
        "source_en",
        "terms_url",
        "license_url",
        "license_note"
      ],
      "additionalProperties": {}
    },
    "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": [
    "official_check",
    "query",
    "tracking_since",
    "history_window",
    "coverage",
    "files_observed",
    "changes",
    "truncated",
    "next_cursor",
    "nta_notice",
    "legal_notice",
    "history_note",
    "attribution",
    "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 recorded4 tools