Oklahoma Code

@pipeworx/oklahoma-code

オクラホマ州法 — 引用による州法の検索、全文トピック検索、改正履歴、および過去の（置き換えられた）バージョンに対応しています。API キーは不要です。

Pipeworx の一部です — AI エージェントを 1721 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとの提携、同社からの承認、または同社による公開を受けていません。

ツール

• ok_statute(citation, version_citeid?) — 引用によるオクラホマ州法の条文全文を返します（「21-701.7」は第一級殺人、「41-111」は賃貸借の終了です）。法令の本文、章の階層、Cite as の行、完全な改正history、およびhistorical_versions配列を返します。各エントリのciteidをversion_citeidとして渡すと、現行版ではなく、その正確な過去版の本文を取得できます。
• ok_search(query, limit?) — 法令の本文（見出しだけではありません）を全文検索し、一致した引用、見出し、施行日、関連度を返します。
• ok_titles() — 法典の全 94 タイトルとその正式名称を返します。主題に適したタイトル番号の特定に使用できます。

認証

API キーは不要です。

ここでは調査の落とし穴に当てはまりませんでした

8 月の州法調査（docs/state-law-probe.md）では、オクラホマ州は「PDF のみで公開」と記録されていました。oklegislature.gov では、94 のタイトルがそれぞれ約 1.2 MB のタイトル単位の PDF として提供されており、条ごとの分割はありません。CO／IN／NJ／GA／KY と同様に、さらに調査したところ、オクラホマ州裁判所ネットワークである OSCN（oscn.net — 州議会ではなく、州裁判所システム自身のサイト）が「Oklahoma Statutes Citationized」の全文を、API キー不要かつ簡素なユーザーエージェントでアクセスできるライブ HTML として提供していました。2025 年の立法会期まで更新されており、さらに 2026 年施行の 2025 年改正も少なくとも 1 件含まれています（2026-10-06 にライブで確認：21 O.S. § 701.7 の「Cite as」行には「(OSCN 2026)」と記載され、最新の改正である Laws 2025 HB 2104 は 2026 年 1 月 1 日に施行されました）。

このファミリーの PDF 抽出パックからの単なる代替ではなく、より優れた情報源であることがわかりました。OSCN は法令本文を対象とする本格的な全文検索を実行し（確認済み — 「landlord」を検索すると、見出しに「landlord」が含まれない 41 O.S. § 111「Termination of Tenancy」が見つかります）、改正で置き換えられた各旧版を、それぞれ直接リンクされた独自のページで保持しています。そのため、このパックでは調査で重視される 4 つの機能、すなわち引用検索、トピック検索、改正履歴、過去のバージョンのすべてを近似や欠落なしで利用できます。過去のバージョンがない Kentucky や、全文検索ではなく見出し検索にとどまる Iowa とは異なります。

引用形式

オクラホマ州では、タイトルと条番号を組み合わせて引用します。たとえば「21-701.7」（Title 21, Crimes and Punishments, Section 701.7）や「41-111」（Title 41, Landlord and Tenant, Section 111）です。ok_statute は「21 O.S. 701.7」「21 O.S. § 701.7」「Title 21, Section 701.7」も受け付けます。94 タイトルのうち 9 つには文字の接尾辞が付きます（3A、10A、12A、14A、27A、37A、43A、75A、85A）。タイトルの一部として渡してください（例：「10A-1」）。

ナビゲーションの構造 — 2 段階で十分であり、ローカルキャッシュを構築しなかった理由

1. Index.asp?ftdb=STOKSTnn&level=1 — タイトル全体のディレクトリです。 FLATTENED（フラット化）されており、すべてのセクションアンカーが 1 ページに表示されます。このデータベースのディレクトリツリーは Title -> Document のみであるためです（実際のサイトで確認済み：章の見出しは同じフラット化されたページ内のインラインマーカーであり、個別に取得できる URL ではありません）。9 つのアルファベット付きタイトルでは、タイトル番号からタイトルの dbcode を導き出すことはできません（10A は STOKST10A ではなく STOKSTA1 です）。そのため、パックにはマスターインデックスページから読み取った完全な静的マップが含まれています。
2. deliverdocument.asp?citeid=NNNNN&PrintOnly=true — セクションそのものです。 PrintOnly は不可欠です。これを省略すると、同じテキストがタイトル全体のナビゲーションツリーを各セクションページに再び埋め込んだ状態で返されます（Title 21 の 1 セクションで 272 KB と実際に確認済み）。PrintOnly を指定すると、そのツリーが取り除かれ、同じセクションは 14 KB になります。

タイトルのインデックスページは約 65 KB（Title 85）から約 610 KB（Title 74、州政府）まであります。これらは、フォントやストリームのデコードが必要なバイナリ PDF ではなく、いくつかの正規表現で解析できるプレーンな HTML です。このタスクで回避しようとしたタイトルごとの PDF フォールバックとは異なり、OSCN がキャッシュ用に提供する、これより小さな単位はありません。実際のサイトで確認したとおり、構造上の最小単位は 1 タイトルであり、最大のページでも安価に解析できます。ok_statute は引き続き、呼び出しごとにこの種の取得を 1 回だけ行い、同じ呼び出しで 2 回目のタイトル取得を行うことはありません。

改正履歴と過去のバージョン

改正されたすべてのセクションの PrintOnly ページ末尾には、Historical Data マーカーと、それに続く、改正法をすべてつないだ 1 つの段落があります。例：「Amended by Laws 2025, HB 2104, c. 486, § 1, eff. January 1, 2026 (superseded document available).」。各「(superseded document available)」は、その直前のバージョンの CiteID への直接リンクです。同じルートで取得すると、その改正前に記載されていたとおりの法令が返され、「Superceded On: MM/DD/YYYY」という見出しが付きます（OSCN 独自の綴りであり、ここで誤植を加えたものではありません）。

データソース

• https://www.oscn.net/applications/oscn/index.asp?ftdb=STOKST — マスタータイトルインデックス（94 タイトル、それぞれの dbcode、Code 全体の最新状態を示す行。例：「Current through the 2025 Legislative Session」）。
• https://www.oscn.net/applications/oscn/Index.asp?ftdb=STOKSTnn&level=1 — 1 タイトル分の完全なセクションディレクトリ（名称 -> CiteID）。ok_statute の引用解決時に使う取得先です。
• https://www.oscn.net/applications/oscn/deliverdocument.asp?citeid=NNNNN&PrintOnly=true — 1 セクション分の全文、パンくずリスト、改正履歴です。CiteID を使って過去の（置き換えられた）バージョンを取得する場合も、変更せずに使用します。
• https://www.oscn.net/applications/oscn/Search.asp?ftdb=STOKST&quick=true&query=landlord&hidesuperseded=Yes&dbCodeText=STOKST&SUBMITTED=true — 94 タイトルすべてにわたる法令本文の全文検索です。 ok_search。

4 つとも、認証情報が不要なプレーンなサーバー生成 HTML です。ログインも JavaScript も不要で、開発中にレート制限は確認されませんでした。サイトのマークアップは UTF-8 ではなく ISO-8859-1 です。パックは UTF-8 と決めつけず、この形式に従ってデコードします。そうしないと、ページ全体で使われている § 文字が文字化けします。

クイックスタート

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

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

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

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

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

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

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ok_statute \
  -H 'Content-Type: application/json' \
  -d '{"citation":"21-701.7"}'

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

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

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

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

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

npx -y @pipeworx/mcp-oklahoma-code

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Oklahoma Code data" })

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

詳細

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

ライセンス

MIT