排期数据 MCP：让 AI 助手直接查绿卡排期

Claude（网页版 claude.ai 和桌面版）

1. 打开 设置（Settings）→ 连接器（Connectors），点「Add custom connector / 添加自定义连接器」。
2. 名字随便起（比如 CareerEngine 排期），粘贴上面的服务器地址。OAuth 那两栏留空。
3. 点 Add。聊天时在输入框左下角「+」→ Connectors 里把它打开。

Claude Code（命令行）：

claude mcp add --transport http careerengine-visa-bulletin https://visa.careerengine.us/api/mcp

ChatGPT

1. 打开 设置（Settings）→ Apps & Connectors → Advanced settings，打开 Developer mode（开发者模式）。
2. 回到 Apps & Connectors，点 Create。起个名字，粘贴服务器地址，Authentication 选「No authentication」。
3. 保存。新开一个对话，在「+」菜单里选上这个连接器。

Cursor

把下面这段加进 ~/.cursor/mcp.json（所有项目）或项目里的 .cursor/mcp.json：

{
  "mcpServers": {
    "careerengine-visa-bulletin": {
      "url": "https://visa.careerengine.us/api/mcp"
    }
  }
}

VS Code（Copilot 智能体模式）

把下面这段加进项目里的 .vscode/mcp.json：

{
  "servers": {
    "careerengine-visa-bulletin": {
      "type": "http",
      "url": "https://visa.careerengine.us/api/mcp"
    }
  }
}

最新一期排期 get_latest_bulletin

CareerEngine 收录的最新一期排期：职业移民 EB-1 到 EB-5、亲属移民 F1 到 F4，每个国家的表 A（最终行动日）和表 B（递交申请日）。日期写成 YYYY-MM-DD，C 表示无排期（current），U 表示不可用。

category (可选)

类别，如 EB-2、EB-1、EB-5 Rural、F2A、F4。不填则返回全部类别。

country (可选)

国家/地区：all（全球，即其他所有国家）、china、india、mexico、philippines；也认「中国」「印度」这样的中文写法。不填则返回全部。

某个类别的历史走势 get_category_history

一个类别、一个国家，逐月的表 A 和表 B 日期。多数类别从 2006-08 起有数据；F2A 可以追溯到 2001-12（中国从 2005-01 起）。表 B 从 2015 年 10 月那期才开始有，更早的月份返回空值。

category (必填)

类别，必填，如 EB-2、EB-3、EB-5 Rural、F4。

country (可选)

国家/地区：all（全球，即其他所有国家）、china、india、mexico、philippines；也认「中国」「印度」这样的中文写法。默认 all。

from (可选)

起始月份，YYYY-MM。默认是结束月份往前 24 个月。

to (可选)

结束月份，YYYY-MM。默认是 CareerEngine 收录的最新一期。

收录了哪些月份 list_bulletins

CareerEngine 收录的排期月份：最早一期（2001-12）、最新一期，以及全部月份的列表。每个月在本站都有对应页面。

year (可选)

四位年份，如 2025，只列这一年的月份。