Oklahoma Code

io.github.pipeworx-iov0.1.0Updated Oct 7, 2026

Oklahoma Statutes — state statutes by citation, full-text topic search,

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingKnowledge & Memory

Overview

AI-generated overview

Lets an assistant look up Oklahoma Statutes by citation, search statutory text by topic, and read amendment history and superseded versions.

What it does
Provides three tools over Oklahoma Statutes: ok_statute returns a section's full text, chapter breadcrumb, cite-as line, amendment history and a list of historical versions retrievable by their own citeid; ok_search runs full-text search over statutory body text and returns matching citations, headings, effective dates and relevancy; ok_titles lists all 94 titles with official names. The remote gateway endpoint also exposes shared Pipeworx meta-tools such as ask_pipeworx and discover_tools.
When to use it
Useful when an assistant needs to quote or verify Oklahoma statutory text, resolve a citation such as 21-701.7, find sections by subject rather than heading, or compare a current section with the version in force before a given amendment.
Requirements
No account, API key or environment variable is declared. The remote endpoint is reached over streamable HTTP at the gateway URL; a local stdio variant is also described as runnable through npx, which needs Node.js. Network access to the gateway or to the underlying court-network site is required.
Before you install
The README states the integration is independent and unofficial, not affiliated with or endorsed by the upstream provider, so text should be checked against an official source before legal use. The gateway endpoint also lists roughly 30 shared meta-tools beyond this pack's own, which adds context and routes questions across the wider catalog. No credentials, payments or write actions are described.

Installation

In SourceWeft

  1. Open Oklahoma Code in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

@pipeworx/oklahoma-code

Oklahoma Statutes — state statutes by citation, full-text topic search, amendment history, and historical (superseded) versions. Keyless.

Part of Pipeworx — an MCP gateway connecting AI agents to 1704+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

  • ok_statute(citation, version_citeid?) — full text of an Oklahoma Statutes section by citation ("21-701.7" is Murder in the First Degree; "41-111" is termination of tenancy). Returns the statute text, its chapter breadcrumb, the "Cite as" line, its full amendment history, and a historical_versions array — each entry's citeid can be passed back as version_citeid to retrieve that EXACT prior version's text instead of the current one.
  • ok_search(query, limit?) — full-text search over statutory BODY TEXT (not just headings), returning matching citations, headings, effective dates, and relevancy.
  • ok_titles() — all 94 titles of the Code with their official names, for routing a subject to the right title number.

Auth

Keyless.

The survey trap did not apply here

The August state-law survey (docs/state-law-probe.md) flagged Oklahoma as "published only as PDF" — oklegislature.gov serves each of the 94 titles as one ~1.2 MB per-title PDF with no per-section split. Looking past that the way CO/IN/NJ/GA/KY did: OSCN, the Oklahoma State Courts Network (oscn.net — the state court system's own site, not the legislature's), serves the full "Oklahoma Statutes Citationized" as live HTML, keyless, bare-UA, current through the 2025 legislative session plus at least one 2026-effective 2025 amendment (verified live 2026-10-06: 21 O.S. § 701.7's own "Cite as" line reads "(OSCN 2026)", and its most recent amendment, Laws 2025 HB 2104, took effect January 1, 2026).

This turned out to be a BETTER source than the PDF-extraction packs in this family, not just an escape from the PDF trap: OSCN runs a real full-text search over statutory body text (confirmed — searching "landlord" surfaces 41 O.S. § 111, "Termination of Tenancy", a heading that never says "landlord") and keeps every superseded prior version of an amended section on its own directly-linked page. So this pack gets all four capabilities the survey cares about — citation lookup, topic search, amendment history, and historical versions — with none of them approximated or unavailable, unlike Kentucky (no historical versions) or Iowa (caption search, not full text).

Citations

Oklahoma cites by title-section, e.g. "21-701.7" (Title 21, Crimes and Punishments, Section 701.7) or "41-111" (Title 41, Landlord and Tenant, Section 111). ok_statute also accepts "21 O.S. 701.7", "21 O.S. § 701.7", and "Title 21, Section 701.7". 9 of the 94 titles carry a letter suffix (3A, 10A, 12A, 14A, 27A, 37A, 43A, 75A, 85A) — pass it as part of the title, e.g. "10A-1".

Navigation shape — two hops, and why no local cache was built

  1. Index.asp?ftdb=STOKSTnn&level=1 — the whole title's directory, FLATTENED: every section anchor appears on one page, because this database's directory tree is only Title -> Document (confirmed live: chapter headers are inline markers within the same flattened page, not separate fetchable URLs). Title dbcodes are NOT derivable from the title number for the 9 lettered titles (10A is STOKSTA1, not STOKST10A) — the pack carries the full static map read off the master index page.
  2. deliverdocument.asp?citeid=NNNNN&PrintOnly=true — the section itself. PrintOnly is load-bearing: dropping it returns the SAME text wrapped in the entire title's navigation tree re-embedded on every single section page (272 KB for one section of Title 21, confirmed live), where PrintOnly strips that tree (14 KB for the same section).

Title index pages range from ~65 KB (Title 85) to ~610 KB (Title 74, State Government) — plain HTML parsed with a handful of regexes, not a binary PDF needing font/stream decoding. Unlike the per-title PDF fallback this task was built to avoid, there is no smaller unit OSCN offers to cache instead — one title is the structural minimum, verified live, and is cheap to parse even at its largest. ok_statute still does only one such fetch per call, never a second title fetch for the same call.

Amendment history and historical versions

Every amended section's PrintOnly page ends with a Historical Data marker followed by one paragraph chaining every amending Act, e.g. "Amended by Laws 2025, HB 2104, c. 486, § 1, eff. January 1, 2026 (superseded document available)." Each "(superseded document available)" is a direct link to that PRIOR version's own CiteID — fetching it through the same route returns the statute exactly as it read before that amendment, headed "Superceded On: MM/DD/YYYY" (OSCN's own spelling, not a typo introduced here).

Data sources

  • https://www.oscn.net/applications/oscn/index.asp?ftdb=STOKST — the master title index (94 titles, their dbcodes, and the Code's overall currency line, e.g. "Current through the 2025 Legislative Session").
  • https://www.oscn.net/applications/oscn/Index.asp?ftdb=STOKSTnn&level=1 — one title's full section directory (name -> CiteID). ok_statute's citation-resolution hop.
  • https://www.oscn.net/applications/oscn/deliverdocument.asp?citeid=NNNNN&PrintOnly=true — one section's full text, breadcrumb, and amendment history. Also used, unchanged, to fetch a historical (superseded) version by its own CiteID.
  • https://www.oscn.net/applications/oscn/Search.asp?ftdb=STOKST&quick=true&query=landlord&hidesuperseded=Yes&dbCodeText=STOKST&SUBMITTED=true — full-text search over statutory body text across all 94 titles. ok_search.

All four are plain, keyless, server-rendered HTML — no login, no JS, no rate limit observed during development. The site's markup is ISO-8859-1 (not UTF-8); the pack decodes accordingly rather than assuming UTF-8, which would otherwise corrupt the § character these pages use throughout.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

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

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/oklahoma-code/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — ask_pipeworx, discover_tools, search_within, remember/recall and the rest of the gateway-wide set. So the tool count you see is larger than this table: a single-pack endpoint currently lists roughly 30 shared tools alongside the pack's own. The connection's initialize response states its exact scope, and is the authoritative answer for a given day.

This is deliberate, not multiplexing by accident. The meta-tools are what let a scoped connection answer a question this pack does not cover — via ask_pipeworx, which routes across the whole catalog — without you adding a second MCP server. There is currently no way to mount a pack endpoint without them; if the extra schemas cost you more context than the routing is worth, connect to the full gateway once rather than to several pack endpoints.

Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:

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

Both URLs reach the same gateway and the same 1704+ data sources. The only difference is which pack's tools are listed directly; ask_pipeworx reaches all of them from either one.

No MCP client? Call it over HTTP

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

No account needed for the first calls. Inspect any tool: GET https://gateway.pipeworx.io/v1/tools/ok_statute. Find one: POST https://gateway.pipeworx.io/v1/tools/search_packs with {"query":"..."}.

Standalone (no gateway account)

This package also runs as a local stdio MCP server — no Pipeworx account, no gateway round-trip:

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

Or run it directly to confirm it starts:

bash
npx -y @pipeworx/mcp-oklahoma-code

It speaks MCP over stdin/stdout and answers initialize/tools/list/tools/call for only this pack's tools — none of the shared meta-tools the gateway connection above adds. Same source, same tools, no ask_pipeworx routing.

Using with ask_pipeworx

Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:

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

The gateway picks the right tool and fills the arguments automatically.

More

License

MIT

Source: README.md at commit ef569e0

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.0LatestOct 7, 2026