Koskamo

Japan Residence Processing Times MCP

Retrieves average processing days for Japan residence applications per status and procedure from ISA's published PDF tables. It provides latest figures, historical series, and status lists, handling gaps and unreadable PDFs explicitly.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Japan Residence Processing Times MCP logo, by MK Career PlanningCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by MK Career Planning
MCP endpoint (Streamable HTTP)
https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp
Vendor documentation

What you can do with it

  • Check average processing days for a specific residence status in the latest period
  • View historical processing time trends for a status of residence
  • List all supported statuses of residence and procedures covered by the data

Source and maintenance

Community listingRegistry 0.1.0

Protocol and capabilities

Server
jp-residence-processing 0.1.0
MCP protocol
2025-06-18
Tools
5 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

5 advertised

catalog — Catalog: tools, prices and limits
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

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

How many days did ISA take on average, in its latest published period, to process a residence application for this status of residence? Give status (key, Japanese or English name), optionally procedure. Returns figures with period, blank cells, the PDF's notes, ISA's PDF URL and retrieval time. Status: found, not_listed (blank, not zero), unknown, unreadable_latest (older readable period, labelled). Averages of approved applications, not a forecast.

residence_processing_latest input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "status"
  ],
  "properties": {
    "status": {
      "type": "string",
      "maxLength": 100,
      "description": "Status of residence: key (e.g. engineer-humanities-international, student, highly-skilled-professional-1a), Japanese name as in ISA's table (e.g. 留学, 高度専門職1号イ) or English name (e.g. Student). Exact match only; see residence_processing_statuses"
    },
    "measure": {
      "enum": [
        "disposition",
        "review_end"
      ],
      "type": "string",
      "description": "Optional: disposition (days to issuance or notification of permission) or review_end (days to the end of examination; extension and change, from FY2020). Omit for both"
    },
    "procedure": {
      "enum": [
        "coe",
        "extension",
        "change"
      ],
      "type": "string",
      "description": "Optional: coe (certificate of eligibility), extension (extension of period of stay) or change (change of status of residence). Omit for all"
    }
  }
}
residence_processing_latest output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query",
    "status",
    "status_note",
    "residence_status",
    "latest_official_period",
    "answer",
    "older_readable",
    "source",
    "provenance",
    "disclaimer",
    "fixed_notes",
    "legal_notice",
    "attribution",
    "answered_at",
    "terms"
  ],
  "properties": {
    "query": {
      "type": "object",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    },
    "answer": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "period",
            "table_layout",
            "figures",
            "blank_cells",
            "notes_as_published"
          ],
          "properties": {
            "period": {
              "anyOf": [
                {
                  "type": "object",
                  "required": [
                    "id",
                    "granularity",
                    "start",
                    "end",
                    "fiscal_quarter"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "end": {
                      "type": "string"
                    },
                    "start": {
                      "type": "string"
                    },
                    "granularity": {
                      "enum": [
                        "month",
                        "quarter"
                      ],
                      "type": "string"
                    },
                    "fiscal_quarter": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "additionalProperties": {}
                },
                {
                  "type": "null"
                }
              ],
              "description": "Period the figures cover (YYYY-MM months; quarters are fiscal, April-June = Q1)."
            },
            "figures": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "procedure",
                  "measure",
                  "days",
                  "days_as_published"
                ],
                "properties": {
                  "days": {
                    "type": "number",
                    "description": "Average number of days as printed by ISA."
                  },
                  "measure": {
                    "enum": [
                      "disposition",
                      "review_end"
                    ],
                    "type": "string",
                    "description": "disposition = days to issuance or notification of permission; review_end = days to the end of examination (extension and change, from FY2020)."
                  },
                  "procedure": {
                    "enum": [
                      "coe",
                      "extension",
                      "change"
                    ],
                    "type": "string",
                    "description": "coe = certificate of eligibility (issuance); extension = extension of period of stay; change = change of status of residence."
                  },
                  "days_as_published": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              }
            },
            "blank_cells": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "procedure",
                  "measure"
                ],
                "properties": {
                  "measure": {
                    "type": "string"
                  },
                  "procedure": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              "description": "Cells that are blank in ISA's table for this period (no figure; not zero)."
            },
            "table_layout": {
              "type": [
                "string",
                "null"
              ]
            },
            "notes_as_published": {
              "type": "string",
              "description": "The notes printed under the table in that period's PDF, as published (Japanese)."
            }
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "source": {
      "type": "object",
      "required": [
        "index_url",
        "pdf_url",
        "fetched_at",
        "index_checked_at",
        "index_check_stale",
        "parser_version",
        "processed_by"
      ],
      "properties": {
        "pdf_url": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISA's PDF the figures were read from."
        },
        "index_url": {
          "type": "string"
        },
        "fetched_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "When this service downloaded that PDF."
        },
        "processed_by": {
          "type": "string"
        },
        "parser_version": {
          "type": "string"
        },
        "index_checked_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "When this service last read ISA's list page successfully."
        },
        "index_check_stale": {
          "type": "boolean"
        }
      },
      "description": "Where the answer comes from: ISA's list page and PDF, and when this service read them.",
      "additionalProperties": {}
    },
    "status": {
      "enum": [
        "found",
        "not_listed",
        "unknown",
        "unreadable_latest"
      ],
      "type": "string",
      "description": "found = figures in the latest period read; not_listed = blank cells in that period (not zero); unknown = no readable data yet; unreadable_latest = ISA's latest PDF could not be read, older_readable has the most recent readable period (older)."
    },
    "disclaimer": {
      "type": "object",
      "required": [
        "en",
        "ja"
      ],
      "properties": {
        "en": {
          "type": "string"
        },
        "ja": {
          "type": "string"
        }
      },
      "description": "Read first: averages of applications approved in the period, as published by ISA; not a forecast for any individual application.",
      "additionalProperties": {}
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "properties": {
          "source": {
            "type": "object",
            "required": [
              "publisher",
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "publisher": {
                "type": "string"
              }
            },
            "description": "Publisher and URL of the upstream document or dataset.",
            "additionalProperties": {}
          },
          "fetch_status": {
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "type": "string",
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          },
          "retrieved_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When this service retrieved the upstream data (null if unknown)."
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "upstream_updated_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Update time stated by the upstream, or null when it states none."
          }
        },
        "description": "Freshness receipt for one upstream source.",
        "additionalProperties": {}
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "answered_at": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "required": [
        "source_ja",
        "processed_ja",
        "source_en",
        "terms_url",
        "license_url",
        "license_note"
      ],
      "properties": {
        "source_en": {
          "type": "string"
        },
        "source_ja": {
          "type": "string"
        },
        "terms_url": {
          "type": "string"
        },
        "license_url": {
          "type": "string"
        },
        "license_note": {
          "type": "string"
        },
        "processed_ja": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "fixed_notes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "en",
          "ja"
        ],
        "properties": {
          "en": {
            "type": "string"
          },
          "ja": {
            "type": "string"
          }
        },
        "additionalProperties": {}
      },
      "description": "Notes that apply to every figure (approvals only, what disposition means, blank is not zero, seasonal peaks)."
    },
    "status_note": {
      "type": "string"
    },
    "legal_notice": {
      "type": "string"
    },
    "older_readable": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "period",
            "table_layout",
            "figures",
            "blank_cells",
            "notes_as_published"
          ],
          "properties": {
            "period": {
              "anyOf": [
                {
                  "type": "object",
                  "required": [
                    "id",
                    "granularity",
                    "start",
                    "end",
                    "fiscal_quarter"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "end": {
                      "type": "string"
                    },
                    "start": {
                      "type": "string"
                    },
                    "granularity": {
                      "enum": [
                        "month",
                        "quarter"
                      ],
                      "type": "string"
                    },
                    "fiscal_quarter": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "additionalProperties": {}
                },
                {
                  "type": "null"
                }
              ],
              "description": "Period the figures cover (YYYY-MM months; quarters are fiscal, April-June = Q1)."
            },
            "figures": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "procedure",
                  "measure",
                  "days",
                  "days_as_published"
                ],
                "properties": {
                  "days": {
                    "type": "number",
                    "description": "Average number of days as printed by ISA."
                  },
                  "measure": {
                    "enum": [
                      "disposition",
                      "review_end"
                    ],
                    "type": "string",
                    "description": "disposition = days to issuance or notification of permission; review_end = days to the end of examination (extension and change, from FY2020)."
                  },
                  "procedure": {
                    "enum": [
                      "coe",
                      "extension",
                      "change"
                    ],
                    "type": "string",
                    "description": "coe = certificate of eligibility (issuance); extension = extension of period of stay; change = change of status of residence."
                  },
                  "days_as_published": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              }
            },
            "blank_cells": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "procedure",
                  "measure"
                ],
                "properties": {
                  "measure": {
                    "type": "string"
                  },
                  "procedure": {
                    "type": "string"
                  }
                },
                "additionalProperties": {}
              },
              "description": "Cells that are blank in ISA's table for this period (no figure; not zero)."
            },
            "table_layout": {
              "type": [
                "string",
                "null"
              ]
            },
            "notes_as_published": {
              "type": "string",
              "description": "The notes printed under the table in that period's PDF, as published (Japanese)."
            }
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ],
      "description": "Only with unreadable_latest: the most recent period this service could read. Older than ISA's latest."
    },
    "residence_status": {
      "type": "object",
      "required": [
        "key",
        "name_ja",
        "name_en"
      ],
      "properties": {
        "key": {
          "type": "string"
        },
        "name_en": {
          "type": "string"
        },
        "name_ja": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "latest_official_period": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "period",
            "state",
            "reason",
            "reason_note",
            "pdf_url"
          ],
          "properties": {
            "state": {
              "enum": [
                "readable",
                "unreadable",
                "fetch_failed",
                "not_yet_read"
              ],
              "type": "string"
            },
            "period": {
              "anyOf": [
                {
                  "type": "object",
                  "required": [
                    "id",
                    "granularity",
                    "start",
                    "end",
                    "fiscal_quarter"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "end": {
                      "type": "string"
                    },
                    "start": {
                      "type": "string"
                    },
                    "granularity": {
                      "enum": [
                        "month",
                        "quarter"
                      ],
                      "type": "string"
                    },
                    "fiscal_quarter": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "additionalProperties": {}
                },
                {
                  "type": "null"
                }
              ],
              "description": "Period the figures cover (YYYY-MM months; quarters are fiscal, April-June = Q1)."
            },
            "reason": {
              "type": [
                "string",
                "null"
              ]
            },
            "pdf_url": {
              "type": "string"
            },
            "reason_note": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ],
      "description": "ISA's latest period on the list page and whether this service could read its PDF."
    }
  },
  "additionalProperties": {}
}
residence_processing_latest annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
residence_processing_history — Japan residence processing time history
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

How has ISA's average processing time for this status of residence changed over time? Give status and optionally procedure and measure. Returns series per granularity (monthly from October 2024, quarterly FY2017 to FY2024 Q2, never mixed or interpolated), procedure and measure, oldest first, with periods that could not be read or are blank listed as gaps with the reason.

residence_processing_history input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "status"
  ],
  "properties": {
    "status": {
      "type": "string",
      "maxLength": 100,
      "description": "Status of residence: key (e.g. engineer-humanities-international, student, highly-skilled-professional-1a), Japanese name as in ISA's table (e.g. 留学, 高度専門職1号イ) or English name (e.g. Student). Exact match only; see residence_processing_statuses"
    },
    "measure": {
      "enum": [
        "disposition",
        "review_end"
      ],
      "type": "string",
      "description": "Optional: disposition (days to issuance or notification of permission) or review_end (days to the end of examination; extension and change, from FY2020). Omit for both"
    },
    "procedure": {
      "enum": [
        "coe",
        "extension",
        "change"
      ],
      "type": "string",
      "description": "Optional: coe (certificate of eligibility), extension (extension of period of stay) or change (change of status of residence). Omit for all"
    }
  }
}
residence_processing_history output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query",
    "status",
    "status_note",
    "residence_status",
    "latest_official_period",
    "series",
    "history_note",
    "source",
    "provenance",
    "disclaimer",
    "fixed_notes",
    "legal_notice",
    "attribution",
    "answered_at",
    "terms"
  ],
  "properties": {
    "query": {
      "type": "object",
      "required": [
        "status"
      ],
      "properties": {
        "status": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    },
    "series": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "granularity",
          "procedure",
          "measure",
          "points",
          "gaps"
        ],
        "properties": {
          "gaps": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "period",
                "reason",
                "reason_note",
                "pdf_url"
              ],
              "properties": {
                "period": {
                  "anyOf": [
                    {
                      "type": "object",
                      "required": [
                        "id",
                        "granularity",
                        "start",
                        "end",
                        "fiscal_quarter"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "end": {
                          "type": "string"
                        },
                        "start": {
                          "type": "string"
                        },
                        "granularity": {
                          "enum": [
                            "month",
                            "quarter"
                          ],
                          "type": "string"
                        },
                        "fiscal_quarter": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "additionalProperties": {}
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Period the figures cover (YYYY-MM months; quarters are fiscal, April-June = Q1)."
                },
                "reason": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "pdf_url": {
                  "type": "string"
                },
                "reason_note": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              },
              "additionalProperties": {}
            }
          },
          "points": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "period",
                "days",
                "days_as_published",
                "pdf_url"
              ],
              "properties": {
                "days": {
                  "type": "number"
                },
                "period": {
                  "anyOf": [
                    {
                      "type": "object",
                      "required": [
                        "id",
                        "granularity",
                        "start",
                        "end",
                        "fiscal_quarter"
                      ],
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "end": {
                          "type": "string"
                        },
                        "start": {
                          "type": "string"
                        },
                        "granularity": {
                          "enum": [
                            "month",
                            "quarter"
                          ],
                          "type": "string"
                        },
                        "fiscal_quarter": {
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      },
                      "additionalProperties": {}
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Period the figures cover (YYYY-MM months; quarters are fiscal, April-June = Q1)."
                },
                "pdf_url": {
                  "type": "string"
                },
                "days_as_published": {
                  "type": "string"
                }
              },
              "additionalProperties": {}
            }
          },
          "measure": {
            "enum": [
              "disposition",
              "review_end"
            ],
            "type": "string"
          },
          "procedure": {
            "enum": [
              "coe",
              "extension",
              "change"
            ],
            "type": "string"
          },
          "granularity": {
            "enum": [
              "month",
              "quarter"
            ],
            "type": "string"
          }
        },
        "additionalProperties": {}
      },
      "description": "One series per granularity, procedure and measure, oldest first. Monthly and quarterly series are separate; nothing is interpolated."
    },
    "source": {
      "type": "object",
      "required": [
        "index_url",
        "pdf_url",
        "fetched_at",
        "index_checked_at",
        "index_check_stale",
        "parser_version",
        "processed_by"
      ],
      "properties": {
        "pdf_url": {
          "type": [
            "string",
            "null"
          ],
          "description": "ISA's PDF the figures were read from."
        },
        "index_url": {
          "type": "string"
        },
        "fetched_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "When this service downloaded that PDF."
        },
        "processed_by": {
          "type": "string"
        },
        "parser_version": {
          "type": "string"
        },
        "index_checked_at": {
          "type": [
            "string",
            "null"
          ],
          "description": "When this service last read ISA's list page successfully."
        },
        "index_check_stale": {
          "type": "boolean"
        }
      },
      "description": "Where the answer comes from: ISA's list page and PDF, and when this service read them.",
      "additionalProperties": {}
    },
    "status": {
      "enum": [
        "found",
        "not_listed",
        "unknown"
      ],
      "type": "string"
    },
    "disclaimer": {
      "type": "object",
      "required": [
        "en",
        "ja"
      ],
      "properties": {
        "en": {
          "type": "string"
        },
        "ja": {
          "type": "string"
        }
      },
      "description": "Read first: averages of applications approved in the period, as published by ISA; not a forecast for any individual application.",
      "additionalProperties": {}
    },
    "provenance": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "source",
          "upstream_updated_at",
          "retrieved_at",
          "content_sha256",
          "parser_version",
          "fetch_status",
          "processed_by"
        ],
        "properties": {
          "source": {
            "type": "object",
            "required": [
              "publisher",
              "url"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "publisher": {
                "type": "string"
              }
            },
            "description": "Publisher and URL of the upstream document or dataset.",
            "additionalProperties": {}
          },
          "fetch_status": {
            "enum": [
              "found",
              "empty",
              "stale",
              "unavailable",
              "unsupported"
            ],
            "type": "string",
            "description": "found / empty / stale / unavailable / unsupported (see catalog fetch_status_values)."
          },
          "processed_by": {
            "type": "string"
          },
          "retrieved_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When this service retrieved the upstream data (null if unknown)."
          },
          "content_sha256": {
            "type": [
              "string",
              "null"
            ]
          },
          "parser_version": {
            "type": "string"
          },
          "upstream_updated_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "Update time stated by the upstream, or null when it states none."
          }
        },
        "description": "Freshness receipt for one upstream source.",
        "additionalProperties": {}
      },
      "description": "Freshness receipts for every upstream source used."
    },
    "answered_at": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "required": [
        "source_ja",
        "processed_ja",
        "source_en",
        "terms_url",
        "license_url",
        "license_note"
      ],
      "properties": {
        "source_en": {
          "type": "string"
        },
        "source_ja": {
          "type": "string"
        },
        "terms_url": {
          "type": "string"
        },
        "license_url": {
          "type": "string"
        },
        "license_note": {
          "type": "string"
        },
        "processed_ja": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "fixed_notes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "en",
          "ja"
        ],
        "properties": {
          "en": {
            "type": "string"
          },
          "ja": {
            "type": "string"
          }
        },
        "additionalProperties": {}
      },
      "description": "Notes that apply to every figure (approvals only, what disposition means, blank is not zero, seasonal peaks)."
    },
    "status_note": {
      "type": "string"
    },
    "history_note": {
      "type": "string"
    },
    "legal_notice": {
      "type": "string"
    },
    "residence_status": {
      "type": "object",
      "required": [
        "key",
        "name_ja",
        "name_en"
      ],
      "properties": {
        "key": {
          "type": "string"
        },
        "name_en": {
          "type": "string"
        },
        "name_ja": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "latest_official_period": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "period",
            "state",
            "reason",
            "reason_note",
            "pdf_url"
          ],
          "properties": {
            "state": {
              "enum": [
                "readable",
                "unreadable",
                "fetch_failed",
                "not_yet_read"
              ],
              "type": "string"
            },
            "period": {
              "anyOf": [
                {
                  "type": "object",
                  "required": [
                    "id",
                    "granularity",
                    "start",
                    "end",
                    "fiscal_quarter"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "end": {
                      "type": "string"
                    },
                    "start": {
                      "type": "string"
                    },
                    "granularity": {
                      "enum": [
                        "month",
                        "quarter"
                      ],
                      "type": "string"
                    },
                    "fiscal_quarter": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "additionalProperties": {}
                },
                {
                  "type": "null"
                }
              ],
              "description": "Period the figures cover (YYYY-MM months; quarters are fiscal, April-June = Q1)."
            },
            "reason": {
              "type": [
                "string",
                "null"
              ]
            },
            "pdf_url": {
              "type": "string"
            },
            "reason_note": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ],
      "description": "ISA's latest period on the list page and whether this service could read its PDF."
    }
  },
  "additionalProperties": {}
}
residence_processing_history annotations
{
  "readOnlyHint": true,
  "openWorldHint": true
}
residence_processing_statuses — Statuses of residence in ISA processing tables
Advertised by the server during the last successful anonymous check.
Advertised read-only

Which statuses of residence and procedures do ISA's processing-time tables cover, and which keys and names does this service accept? Returns the canonical list (key, Japanese and English names), procedures and measures.

residence_processing_statuses input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
residence_processing_statuses output schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "statuses",
    "procedures",
    "matching_note",
    "disclaimer",
    "fixed_notes",
    "legal_notice",
    "attribution",
    "answered_at",
    "terms"
  ],
  "properties": {
    "terms": {
      "type": "string",
      "description": "URL of the terms of service."
    },
    "statuses": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "key",
          "name_ja",
          "name_en",
          "group_ja"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "name_en": {
            "type": "string"
          },
          "name_ja": {
            "type": "string"
          },
          "group_ja": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": {}
      }
    },
    "disclaimer": {
      "type": "object",
      "required": [
        "en",
        "ja"
      ],
      "properties": {
        "en": {
          "type": "string"
        },
        "ja": {
          "type": "string"
        }
      },
      "description": "Read first: averages of applications approved in the period, as published by ISA; not a forecast for any individual application.",
      "additionalProperties": {}
    },
    "procedures": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "key",
          "name_ja",
          "name_en",
          "measures"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "name_en": {
            "type": "string"
          },
          "name_ja": {
            "type": "string"
          },
          "measures": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": {}
      }
    },
    "answered_at": {
      "type": "string"
    },
    "attribution": {
      "type": "object",
      "required": [
        "source_ja",
        "processed_ja",
        "source_en",
        "terms_url",
        "license_url",
        "license_note"
      ],
      "properties": {
        "source_en": {
          "type": "string"
        },
        "source_ja": {
          "type": "string"
        },
        "terms_url": {
          "type": "string"
        },
        "license_url": {
          "type": "string"
        },
        "license_note": {
          "type": "string"
        },
        "processed_ja": {
          "type": "string"
        }
      },
      "additionalProperties": {}
    },
    "fixed_notes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "en",
          "ja"
        ],
        "properties": {
          "en": {
            "type": "string"
          },
          "ja": {
            "type": "string"
          }
        },
        "additionalProperties": {}
      },
      "description": "Notes that apply to every figure (approvals only, what disposition means, blank is not zero, seasonal peaks)."
    },
    "legal_notice": {
      "type": "string"
    },
    "matching_note": {
      "type": "string"
    }
  },
  "additionalProperties": {}
}
residence_processing_statuses annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
get_receipt — Get receipt of a paid call
Advertised by the server during the last successful anonymous check.
Advertised read-only

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 30 days after settlement.

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

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1218 ms
95th percentile latency
1218 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1218 ms · metadata changed · 5 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http japan-residence-processing-times-mcp https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add japan-residence-processing-times-mcp --url https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable japan-residence-processing-times-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "japan-residence-processing-times-mcp": {
      "url": "https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "japan-residence-processing-times-mcp": {
      "type": "streamableHttp",
      "url": "https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start japan-residence-processing-times-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "japan-residence-processing-times-mcp": {
      "type": "http",
      "url": "https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http japan-residence-processing-times-mcp https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "japan-residence-processing-times-mcp": {
      "url": "https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "japan-residence-processing-times-mcp": {
      "serverUrl": "https://jp-residence-processing-production.mk-career-planning.workers.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Japan Residence Processing Times MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.