排期數據 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，只列這一年的月份。