@pipeworx/oklahoma-code

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/oklahoma-code’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 3

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

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.

Tools

• ok_statute — Get the FULL TEXT of a section of the Oklahoma Statutes by citation, e.g. “21-701.7” (Murder in the First Degree) or “41-111” (termination of tenancy). Accepts “21-701.7”, “21 O.S. 701.7”, or “21 O.S.
• ok_search — Search the Oklahoma Statutes by TOPIC or keyword rather than citation, e.g. “landlord”, “concealed carry permit”, “DUI per se limit”. Real full-text search over statutory body text (not just captions)
• ok_titles — List all 94 titles of the Oklahoma Statutes with their official names, e.g. Title 21 is Crimes and Punishments, Title 41 is Landlord and Tenant. Routing help for when you know the subject but not the