Macau Amcm

@pipeworx/macau-amcm

AMCM（マカオ金融管理局、Autoridade Monetária de Macau / 澳門金融管理局）によるマカオの金融データです。マカオ・パタカ（MOP）と約17通貨との日次銀行間外国為替仲値、およびMONIA（MOP翌日物金利平均）を提供します。MONIAはマカオの翌日物銀行間基準金利です。

Pipeworx の一部です。AI エージェントを1882以上の稼働中データソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携しておらず、承認や公開も受けていません。

ツール

• macau_fx_rates({ begin?, end?, currency? }) — マカオの各営業日について、通貨ごとの日付付きMOP仲値を返します。デフォルトでは、直近の公開日までの過去7日間を対象とします。begin／end はYYYY-MM-DD形式で、1回の呼び出しにつき最大約1年間を指定できます。currency はカンマ区切りのISOコード（「USD,HKD,CNY」）で絞り込みます。
• macau_monia({ begin?, end? }) — 同じ期間指定で、日次MONIA確定値をパーセント単位で返します。

認証

キーは不要です。登録、キー、Cookieは必要ありません。エンドポイントは、AMCMの公式レートページが表の読み込みに使用するものと同じJSON APIです。

データソース

• https://www.amcm.gov.mo/api/v1.0/cms/financial_info?QueryType=ExchangeRate|Monia&Begin=YYYYMMDD&End=YYYYMMDD
• https://www.amcm.gov.mo/api/v1.0/cms/last_data_date?QueryType=... — デフォルトの期間に使われる直近の公開日です（週末とマカオの祝日は公開されません）。

次の担当者への注意点

• usdMean は米ドルのレートではありません。 名前に反して、usdMean／usdMeanValue は各通貨のunitあたりのMOP仲値です。USDの行は約8.08（1 USDあたりのMOP）、HKDの行は約1.03（MOPとHKDのペッグ）です。2026-09-07に実データで確認済みです。このパッケージではmop_per_unitとして公開しています。
• JPYとKRWはunit = 100あたり、それ以外は1あたりで表示されます。 通貨間で比較する前に、unitフィールドを確認してください。
• bidの意味は行ごとに異なります。 各通貨の市場慣行に基づく第2の相場です。EUR／GBP／AUD／NZDでは1単位あたりのUSD、JPY／CHF／SGD／SEK／NOKなどでは1 USDあたりの通貨単位、CNYでは100 USDあたりのCNY、USDの行ではUSD／HKDです。この注意点とともにmarket_quoteとして公開しています。MOP建ての値が必要な場合はmop_per_unitを使用してください。
• FX一覧にはunit: 0のLIQ行があります。 これはAMCMの流動性指標であり、通貨ではありません。FXツールでは除外しています。
• 対象期間が空でも異常ではありません。 AMCMはマカオの営業日にのみ公開するため、週末や祝日のみを含む期間では行が0件になります。ツールはこれを検出してlast_data_dateを取得し、実際の日付を指定して再リクエストできるよう、レスポンスに含めて返します。
• 以前のchina-verticalプローブ（fleet #1311）は、AMCMはXLSダウンロードのみと想定していました。上記のJSON APIはサイト自身のページで使用されており、スクレイピングは不要です。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "macau-amcm": {
      "url": "https://gateway.pipeworx.io/macau-amcm/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/macau-amcm/mcp の tools/list は、上の表にあるツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールに加えて、共有ツールが約 30 個リストされます。接続の initialize レスポンスに正確な範囲が記載されており、その日の状況を確認するうえで最も確かな情報です。

これは意図的な仕様であり、偶然の多重化ではありません。メタツールを使えば、このパックで扱っていない質問にも、カタログ全体を検索する ask_pipeworx 経由で回答できます。2 つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利便性を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接リストされます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1882+ のデータソースに接続します。違いは、どのパックのツールが直接リストされるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/macau_fx_rates \
  -H 'Content-Type: application/json' \
  -d '{}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/macau_fx_rates を実行します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "macau-amcm": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-macau-amcm"]
    }
  }
}

または、直接実行して起動を確認できます。

npx -y @pipeworx/mcp-macau-amcm

stdin/stdout 経由で MCP を使用し、このパックのツールだけを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントとフルゲートウェイの両方で利用できます。

ask_pipeworx({ question: "your question about Macau Amcm data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT