Japan TITP Administrative Actions

Published TITP actions (ISA) on Japanese intern supervising/implementing orgs. Tracks file 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,992Tokens (tool definitions)
~15.3 KBTypical response size
Significant attention impact (3.90% 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-titp-actions": {
      "url": "https://jp-titp-actions-production.mk-career-planning.workers.dev/mcp"
    }
  }
}

Remote endpoints

https://jp-titp-actions-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": {}
}
🟢titp_action_lookup(name, permit_number, certification_number, prefecture, limit)

Has this TITP supervising or implementing organization in Japan had an administrative action published by ISA, and when? Look up by permit number (1708000404), plan certification number (1704019156) or organization name (exact after normalization; partial = candidates), optional prefecture. Returns listed, not_found_in_checked_records (not proof of no action; actions no longer published are not returned) or unknown, with type, date, reason as published, source file and as-of date.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "Organization name as published (Japanese), at least 2 characters. Width, case, spaces and line breaks are ignored",
      "type": "string",
      "maxLength": 100
    },
    "permit_number": {
      "description": "Supervising organization permit number, e.g. 許1708000404 or 1708000404",
      "type": "string",
      "maxLength": 30
    },
    "certification_number": {
      "description": "Technical intern training plan certification number, e.g. 認1704019156, 変認1809000128 or the digits",
      "type": "string",
      "maxLength": 30
    },
    "prefecture": {
      "description": "Optional filter: prefecture of the published address (Tokyo or 東京都), JIS code (13) or local government code (130001)",
      "type": "string",
      "maxLength": 20
    },
    "limit": {
      "description": "Maximum number of actions per list, 1-100 (default 20)",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$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: confirm on the official ISA page listed here before relying on this answer."
    },
    "query": {
      "type": "object",
      "properties": {
        "name": {
          "type": [
            "string",
            "null"
          ]
        },
        "permit_number": {
          "type": [
            "string",
            "null"
          ]
        },
        "certification_number": {
          "type": [
            "string",
            "null"
          ]
        },
        "prefecture": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "name",
        "permit_number",
        "certification_number",
        "prefecture"
      ],
      "additionalProperties": {}
    },
    "status": {
      "type": "string",
      "enum": [
        "listed",
        "not_found_in_checked_records",
        "unknown"
      ],
      "description": "listed = an action matching by number or exact name is in the ISA files checked; not_found_in_checked_records = no match in the files checked (does not mean no action was taken; actions ISA no longer publishes are not returned); unknown = not loaded, stale, a file unreadable, or candidates only."
    },
    "status_note": {
      "type": "string"
    },
    "unknown_reason": {
      "type": [
        "string",
        "null"
      ]
    },
    "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": {}
    },
    "actions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "action_id": {
            "type": "string",
            "description": "This service's id for the action."
          },
          "listed": {
            "type": "boolean"
          },
          "status_statement": {
            "type": "string"
          },
          "action_type": {
            "type": "string",
            "enum": [
              "improvement_order",
              "certification_revocation",
              "permit_revocation",
              "business_suspension_order"
            ]
          },
          "action_type_ja": {
            "type": "string",
            "description": "Action type as named by ISA (改善命令 / 認定の取消し / 許可の取消し)."
          },
          "target_type": {
            "type": "string",
            "enum": [
              "supervising_organization",
              "implementing_organization"
            ]
          },
          "organization_name": {
            "type": "string",
            "description": "Name as published by ISA."
          },
          "prefecture": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name_ja": {
                    "type": "string"
                  },
                  "name_en": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "name_ja",
                  "name_en"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          },
          "municipality_ja": {
            "type": [
              "string",
              "null"
            ]
          },
          "action_date": {
            "description": "Date of the action (YYYY-MM-DD), normalized from the published cell.",
            "type": [
              "string",
              "null"
            ]
          },
          "action_date_as_published": {
            "description": "The published date cell as is (an Excel serial number or a Japanese-era date).",
            "type": [
              "string",
              "null"
            ]
          },
          "permit_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "certification_numbers_count": {
            "type": "number"
          },
          "first_seen_at": {
            "type": "string"
          },
          "last_seen_at": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "action_id",
          "listed",
          "status_statement",
          "action_type",
          "action_type_ja",
          "target_type",
          "organization_name",
          "prefecture",
          "municipality_ja",
          "action_date",
          "action_date_as_published",
          "permit_number",
          "certification_numbers_count",
          "first_seen_at",
          "last_seen_at"
        ],
        "additionalProperties": {}
      }
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "action_id": {
            "type": "string",
            "description": "This service's id for the action."
          },
          "listed": {
            "type": "boolean"
          },
          "status_statement": {
            "type": "string"
          },
          "action_type": {
            "type": "string",
            "enum": [
              "improvement_order",
              "certification_revocation",
              "permit_revocation",
              "business_suspension_order"
            ]
          },
          "action_type_ja": {
            "type": "string",
            "description": "Action type as named by ISA (改善命令 / 認定の取消し / 許可の取消し)."
          },
          "target_type": {
            "type": "string",
            "enum": [
              "supervising_organization",
              "implementing_organization"
            ]
          },
          "organization_name": {
            "type": "string",
            "description": "Name as published by ISA."
          },
          "prefecture": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name_ja": {
                    "type": "string"
                  },
                  "name_en": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "name_ja",
                  "name_en"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          },
          "municipality_ja": {
            "type": [
              "string",
              "null"
            ]
          },
          "action_date": {
            "description": "Date of the action (YYYY-MM-DD), normalized from the published cell.",
            "type": [
              "string",
              "null"
            ]
          },
          "action_date_as_published": {
            "description": "The published date cell as is (an Excel serial number or a Japanese-era date).",
            "type": [
              "string",
              "null"
            ]
          },
          "permit_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "certification_numbers_count": {
            "type": "number"
          },
          "first_seen_at": {
            "type": "string"
          },
          "last_seen_at": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "required": [
          "action_id",
          "listed",
          "status_statement",
          "action_type",
          "action_type_ja",
          "target_type",
          "organization_name",
          "prefecture",
          "municipality_ja",
          "action_date",
          "action_date_as_published",
          "permit_number",
          "certification_numbers_count",
          "first_seen_at",
          "last_seen_at"
        ],
        "additionalProperties": {}
      }
    },
    "total": {
      "type": "number"
    },
    "truncated": {
      "type": "boolean"
    },
    "data_version": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "page_as_of": {
              "type": [
                "string",
                "null"
              ]
            },
            "files": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {},
                "additionalProperties": {}
              }
            },
            "tracking_since": {
              "type": "string"
            }
          },
          "required": [
            "page_as_of",
            "files",
            "tracking_since"
          ],
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "action_notice": {
      "type": "object",
      "properties": {
        "en": {
          "type": "string"
        },
        "ja": {
          "type": "string"
        }
      },
      "required": [
        "en",
        "ja"
      ],
      "additionalProperties": {},
      "description": "Always pass on: the action is as published on the date shown; it does not mean the organization currently has problems."
    },
    "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",
    "registry_status",
    "actions",
    "candidates",
    "total",
    "truncated",
    "data_version",
    "action_notice",
    "legal_notice",
    "attribution",
    "answered_at",
    "provenance",
    "terms"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}
🟢titp_action_changes(since, change_type, target_type, limit)

Which TITP administrative actions were added to or changed in ISA's published files since a date? From this service's own record of file versions (ISA publishes only the current files). Each change has the action id, observed_at, changed fields and before/after. Actions that ISA no longer publishes are not returned; only the number that left the files per version is shown, without identifiers. History starts at tracking_since. Free window: last 30 days.

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 or 2026-10-01T00:00:00Z"
    },
    "change_type": {
      "description": "Optional filter: added or modified",
      "type": "string",
      "enum": [
        "added",
        "modified"
      ]
    },
    "target_type": {
      "description": "Optional filter: supervising_organization or implementing_organization",
      "type": "string",
      "enum": [
        "supervising_organization",
        "implementing_organization"
      ]
    },
    "limit": {
      "description": "Maximum number of changes, 1-500 (default 100)",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "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: confirm on the official ISA page listed here before relying on this answer."
    },
    "query": {
      "type": "object",
      "properties": {
        "since": {
          "type": "string"
        }
      },
      "required": [
        "since"
      ],
      "additionalProperties": {}
    },
    "tracking_since": {
      "description": "When this service first loaded the files. 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": {}
    },
    "removals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "observed_at": {
            "type": "string"
          },
          "count": {
            "type": "number"
          },
          "statement": {
            "type": "string"
          }
        },
        "required": [
          "observed_at",
          "count",
          "statement"
        ],
        "additionalProperties": {}
      },
      "description": "Number of actions that left ISA's published files per version. No identifiers: actions ISA no longer publishes are not returned."
    },
    "changes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "observed_at": {
            "type": "string"
          },
          "change_type": {
            "type": "string",
            "enum": [
              "added",
              "modified"
            ]
          },
          "action_id": {
            "type": "string"
          },
          "statement": {
            "type": "string"
          },
          "changed_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "before": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "action_type": {
                    "type": "string",
                    "enum": [
                      "improvement_order",
                      "certification_revocation",
                      "permit_revocation",
                      "business_suspension_order"
                    ]
                  },
                  "target_type": {
                    "type": "string",
                    "enum": [
                      "supervising_organization",
                      "implementing_organization"
                    ]
                  },
                  "organization_name": {
                    "type": "string"
                  },
                  "action_date": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "action_type",
                  "target_type",
                  "organization_name",
                  "action_date"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          },
          "after": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "action_type": {
                    "type": "string",
                    "enum": [
                      "improvement_order",
                      "certification_revocation",
                      "permit_revocation",
                      "business_suspension_order"
                    ]
                  },
                  "target_type": {
                    "type": "string",
                    "enum": [
                      "supervising_organization",
                      "implementing_organization"
                    ]
                  },
                  "organization_name": {
                    "type": "string"
                  },
                  "action_date": {
                    "type": [
                      "string",
                      "null"
                    ]
                  }
                },
                "required": [
                  "action_type",
                  "target_type",
                  "organization_name",
                  "action_date"
                ],
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "observed_at",
          "change_type",
          "action_id",
          "statement",
          "changed_fields",
          "before",
          "after"
        ],
        "additionalProperties": {}
      },
      "description": "Changes observed by this service between file versions, oldest first."
    },
    "truncated": {
      "type": "boolean"
    },
    "action_notice": {
      "type": "object",
      "properties": {
        "en": {
          "type": "string"
        },
        "ja": {
          "type": "string"
        }
      },
      "required": [
        "en",
        "ja"
      ],
      "additionalProperties": {},
      "description": "Always pass on: the action is as published on the date shown; it does not mean the organization currently has problems."
    },
    "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",
    "removals",
    "changes",
    "truncated",
    "action_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