Oklahoma Code 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 1721+ 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.):

{
  "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:

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

Both URLs reach the same gateway and the same 1721+ 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

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:

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

Or run it directly to confirm it starts:

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

• Docs and guides
• pipeworx.io

License

MIT