Ca Debtwatch

@pipeworx/ca-debtwatch

カリフォルニア州の地方債発行 — 1984年以降、カリフォルニア州債務・投資諮問委員会（CDIAC）に報告された、州および地方自治体によるすべての債券、ノート、参加証書、Mello-Roos特別税案件を、発行単位で収録しています。元本、売却日、債務の種類、目的、格付け、利息コスト、発行手数料に加え、案件の引受会社、地方債アドバイザー、債券顧問弁護士も確認できます。

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

これはプライマリー市場での発行データであり、流通市場の取引テープではありません。MSRB/EMMAのコンテンツを含まず、CUSIPにも依存しません。CDIACはこのデータをカリフォルニア州の公開データとして提供しています。

ツール

• ca_debt_search_issues(...) — 発行体、郡、債務の種類、目的、課税区分、ESGラベル、売却日、元本額で、カリフォルニア州の76,000件以上の案件を検索します。中心となるツールです。
• ca_debt_issue(cdiac_number) — 1件の案件の詳細を表示します。参加者別の発行コスト（引受会社の引受手数料、アドバイザー報酬、債券および開示に関する顧問弁護士報酬、受託者報酬、格付け機関報酬）や、後年にその案件に対して提出された年次債務透明性報告書の各行も含まれます。
• ca_debt_issuer_profile(issuer) — 1つの発行体の借入履歴を表示します。元本総額、案件数、期間、債務の種類と目的別の内訳、最大および最新の案件を確認できます。
• ca_debt_statewide_totals() — 州財務官が公表する州全体の主要な合計値（年初来の発行済み債務、年初来の地方債発行額、発行予定だが未売却の債務、直近の長期債発行額）を表示します。
• ca_debt_filter_options(field?) — CDIACが各列挙型フィルターで使用する正確な表記を表示します。
• ca_debt_resolve_issuer(name) — 部分的な名称から、CDIACが使用する正確な発行体名を特定します。

認証

キーは不要です。登録、キー、公開されている利用上限はありません。

データソース

• https://debtwatch.treasurer.ca.gov/env.json — SPA自体が読み込むAPIのベース情報です。ハードコードせず、アイソレートごとに一度解決し、現在の値へのフォールバックも用意しています。
• PUT /api/dataset/issues/search — 発行案件の検索です。GETでもPOSTでもなく、PUTです。
• GET /api/dataset/issues — 各列挙型フィルターで受け付けられる値を含む、列のメタデータです。
• GET /api/dataset/issues/element/Issuer/search?q=&pageNumber=N — 発行体の候補検索（7,600以上の発行体）です。10件単位でページ分割され、ページサイズのパラメーター（pageSize、take、limit）はすべて無視されます（いずれも機能しません）。totalValuesには正確な件数が報告されますが、機能するのはpageNumberだけです。1ページ目だけを読み込むと、「san diego」に該当する発行体が47件あるにもかかわらず10件に見え、後のページに表示される名前（San Diego Unified Port District）を正確に指定しても、その名前を含まない候補が表示され、曖昧な結果になります。このパックは上限を設けてページを取得し、途中で停止した場合はその旨を報告します。
• GET /api/report/issuance-detail-with-history/{cdiacNumber} — 単一案件の詳細と、後年に提出されたADTRです。
• GET /api/fast-stat — 州全体の主要な合計値です。

触れる前に知っておきたいこと

• 不正なフィルターは、400 ではなく本文のない HTTP 500 を返します。 本文も検証メッセージもありません。フィルターは列 ID をキーとし、type 識別子を持ちます。SPA バンドルから読み取った型は、StringOneOf／StringContainsOneOf（options: []）、DateBetween／DateOnOrAfter／DateOnOrBefore／DateEqualTo（minimum／maximum／exactly）、NumberBetween／NumberGreaterThanOrEqualTo／NumberLessThanOrEqualTo、BooleanEqualTo（exactly）です。それ以外はすべて 500 になります。
• 複数値を取る列は IssuerCounty です。 StringContainsOneOf が必要です。この列に対して StringOneOf を送信すると、エラーにはならず、何も一致しません。
• テキストフィルターは CDIAC の表記と完全一致します。 少しでも異なると、エラーではなく、行数 0 の 200 が返されます。たとえば、Los Angeles と Los Angeles Unified School District は別の発行体です。このパックでは、列挙型の引数はすべて上流のオプションリストと照合し、発行体の引数はすべてタイプアヘッドエンドポイントで照合するため、ユーザーが一般的な呼び方で指定しても行を取得できます。解決できない引数は破棄せず、候補を返します。
• フィルターごとの values エンドポイントはありません。 オプションリストは GET /api/dataset/issues 内の columns[].filter.values.all にインラインで含まれており、対象は AllAtOnce 戦略を使う列です。カーディナリティの高い列は ByAsyncSearchOnly で、element/{col}/search のタイプアヘッドからのみアクセスできます。
• SaleDate には発行予定案件の将来の日付も含まれるため、降順で並べ替えると、まだ成立していない案件が先頭に表示されます。これらは sold_status で区別できます。
• 対象はカリフォルニア州のみです。無料で利用できる全国版の代替手段はありません。MSRB／EMMA の利用規約では、再配布可能なデータベースの構築が禁じられています。

クイックスタート

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

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

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

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

これは意図的な設計であり、意図せず多重化されているわけではありません。メタツールを使うと、このパックでは扱えない質問にも、カタログ全体に振り分ける ask_pipeworx を通じて回答できます。MCP サーバーを追加でもう 1 つ設定する必要はありません。現在、メタツールなしでパックエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

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

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

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

MCP クライアントがない場合は、HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/ca_debt_search_issues \
  -H 'Content-Type: application/json' \
  -d '{"issuer":"Los Angeles Unified School District","limit":5}'

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

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

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

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

または、直接実行して起動することを確認します。

npx -y @pipeworx/mcp-ca-debtwatch

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

ask_pipeworx での使用

ツールを直接呼び出す代わりに、平易な英語で質問できます。 これは、上記のパックエンドポイントだけでなく、フルゲートウェイでも機能します。

ask_pipeworx({ question: "your question about Ca Debtwatch data" })

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

詳細

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

ライセンス

MIT