Ny Authority Debt

ny-authority-debt

ニューヨーク州の公的機関による債券発行について、どの機関が、どのプロジェクトのために、どのような条件で、いつ借り入れたのかを確認できます。ニューヨーク州が data.ny.gov で公開している Authorities Budget Office の4つのデータセットを出典としています。キーは不要です。

Pipeworx の一部です。AI エージェントを1683以上の稼働中のデータソースに接続する MCP ゲートウェイです。

ツール

ツール	回答内容
ny_authority_debt_search	ニューヨーク州では、どの機関が、どのプロジェクト向けに、どの規模・日付・税務上の扱いで債券を発行しましたか？
ny_authority_debt_profile	ある機関が発行したすべての債券と、年別および新規資金調達・借換え別の合計を確認できます。
ny_authority_debt_totals	年別・機関種別の借入総額と、発行額が最大の機関を確認できます。
ny_authority_debt_coverage	対象範囲、遡れる期間、そして明示的に対象外となる内容を確認できます。

対象範囲

4つの機関種別、報告行数は約4,470件です。

種別	データセット	行数
州機関	83xh-6x8i	1,617
地方機関	qbd7-9grw	814
産業開発機関	cci8-aavx	632
地方開発法人	sh2f-cc7d	1,410

各行は、ある機関がある会計年度について報告した内容です。 issued_debt_obligations が N の行は、その年度に当該機関が何も発行しなかったことを意味します。ある機関が発行しなかった年が、フィールドの空欄を伴う発行として見えることがないよう、ツールでは Y の行に絞り込んでいます。

対象外の内容

• 流通市場での取引価格はありません。 これは新規発行に関するデータで、何がどのような条件で売却されたかを示します。それ以外では、多くの地方債は取引頻度が低く、現在の市場価格が存在しません。業者が地方債の「価格」として販売するものは、通常、取引価格ではなく推定値である評価価格です。そうでないと思い込んだ呼び出し元は、データがないことを「取引がなかった」と解釈してしまいます。
• CUSIP はありません。 詳細は以下をご覧ください。
• 対象はニューヨーク州のみです。 カリフォルニア州については ca-debtwatch が対象です。どこかの個別債券を特定するには、marketSecDes: "Muni" を指定して openfigi_search を使用してください。

コード設計を左右した2つの制約

CUSIP は意図的に除外しています。 State Authorities のデータセットには cusip_number 列があり、1,295行に実在する9文字の CUSIP が登録されています。CUSIP 識別子は CUSIP Global Services のライセンス対象であり、基礎となる事実の著作権ではなく、そのライセンスが拘束力のある制約となります。この列は返却前に削除され、CUSIP による絞り込み機能はなく、何も保存されません。ここでは発行体名をキーにし、個別債券については openfigi 経由で FIGI を使用してください。CUSIP を再追加しないでください。

EMMA はリンクするだけで、取得しません。 MSRB の利用規約は、EMMA を利用することで同意した契約であり、そのコンテンツからデータベースを構築することを禁じています。このパックが返す official_statement_url は、ニューヨーク州自身が公開したリンクです。多くは emma.msrb.org でホストされる PDF ですが、機関独自のサイトへのリンクの場合もあります。リンクはリクエストも解析もせず、そのまま渡します。emma_search_url は、実態に即した名称を付けた検索リンクです。このパスは200を返しますが、ページはスクリプト駆動のため、意図的に解析していません。そのため、検索条件が事前入力されない場合があります。

データソース

• ニューヨーク州オープンデータ — https://data.ny.gov（Authorities Budget Office の債券発行報告）

注意点：Socrata のカタログ検索は州をまたいで結果を集約します

別の州の Socrata カタログ（例：data.texas.gov）をクエリすると、カタログ API が結果を集約するため、同じデータセット ID が返されます。テキサス州はこれらを公開していません。カタログ検索結果の metadata.domain を必ず確認してから、データセットを州に帰属させてください。2026-09-01 に確認したところ、4つすべての domain: data.ny.gov が報告されています。

クイックスタート

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

{
  "mcpServers": {
    "ny-authority-debt": {
      "url": "https://gateway.pipeworx.io/ny-authority-debt/mcp"
    }
  }
}

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

https://gateway.pipeworx.io/ny-authority-debt/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 も、同じゲートウェイと同じ1,683以上のデータソースに接続します。異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがなくても HTTP で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/ny_authority_debt_search \
  -H 'Content-Type: application/json' \
  -d '{"authority":"Dormitory","min_amount":100000000,"limit":3}'

最初の呼び出しにはアカウントは必要ありません。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/ny_authority_debt_search を使います。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

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

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

{
  "mcpServers": {
    "ny-authority-debt": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ny-authority-debt"]
    }
  }
}

起動することを確認するには、直接実行することもできます。

npx -y @pipeworx/mcp-ny-authority-debt

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

ask_pipeworx の使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Ny Authority Debt data" })

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

詳細

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

ライセンス

MIT