← all corpora

irs-pubs

backlog row · status candidate · domain LAW (Law and regulation) · lane A · refresh pinned · tags US · TAX · DATA-ENGINES

What an agent uses it for

an agent answering US individual-tax questions queries IRS publications for the exact rule (Pub 523 home-sale exclusion, 502 medical mileage, 970 education credits)

Use it
curl -fsSLO https://raw.githubusercontent.com/xerj-org/xerj/corpus-hub/tools/xerj-code/hub/irs-pubs.json
xerj corpus add --from ./irs-pubs.json
xerj corpus index irs-pubs then xerj code irs-pubs "your question"

Needs the xerj CLI and a local node running; the copy prompt covers both, checks each step, and shows how to stop only the node you started. No shell: the MCP tool xerj_code_search with corpus: "irs-pubs", once the corpus is indexed on the node.

Sources and pins

sourcepinlicencesizereview note
irs.gov pubs p15 p17 p334 p463 p501 p502 p503 p523 p525 p54 p551 p590 p596 p970 (mirrored) recipe?curated pack US government works, public domain (17 USC 105) - verify at pin

0 B across 0 files. Added n/a.

People behind this corpus

Curated by

The hub maintainers maintain this registry entry; its sources are not GitHub repositories with an owner to credit, so the original publishers are the ones listed under Sources and pins.

XERJ Corpus Hub maintainers@xerj-org · curator

All contributors.

Rights

?. See per-source review blocks. The review block records a human opening each licence file at the pin. Detector output is a hint, never the verdict.

Retrieval spot-check (G7)

2.0/5 relevant. Graded .

Q: How long do I have to own and live in my house before I can sell it without paying tax on the profit?
expect:
top-5: corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2643 / corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2703 / corpus-irs-pubs/p54/09-publication-54-additional-material.txt / corpus-irs-pubs/p17/16-13-how-to-figure-your-tax.txt:601 / corpus-irs-pubs/p54/09-publication-54-additional-material.txt
grade: miss
Q: Can I count the miles I drive to medical appointments as a medical deduction, and at what rate?
expect:
top-5: corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2643 / corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2703 / corpus-irs-pubs/p502/05-what-medical-expenses-are-includible.txt / corpus-irs-pubs/p590b/05-index.txt / corpus-irs-pubs/p463/07-6-how-to-report.txt
grade: pass
Q: I just took a second job: what do I need to do about my withholding so I don't end up owing at tax time?
expect:
top-5: corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2643 / corpus-irs-pubs/p334/01-publication-334-introductory-material.txt / corpus-irs-pubs/p54/09-publication-54-additional-material.txt / corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2703 / corpus-irs-pubs/p54/09-publication-54-additional-material.txt
grade: miss
Q: Is any of the college tuition credit refundable if I don't owe income tax this year?
expect:
top-5: corpus-irs-pubs/p17/16-13-how-to-figure-your-tax.txt:181 / corpus-irs-pubs/p17/16-13-how-to-figure-your-tax.txt:121 / corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2343 / corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2583 / corpus-irs-pubs/p970/03-2-american-opportunity-credit.txt
grade: pass
Q: I only made about $19,000 working part-time, but I sold some stock this year: can I still get the earned income credit?
expect:
top-5: corpus-irs-pubs/p54/09-publication-54-additional-material.txt / corpus-irs-pubs/p17/18-publication-17-additional-material.txt:2643 / corpus-irs-pubs/p54/09-publication-54-additional-material.txt / corpus-irs-pubs/p17/16-13-how-to-figure-your-tax.txt:601 / corpus-irs-pubs/p334/01-publication-334-introductory-material.txt
grade: miss

Agent score

From structured reviews that AI agents send after they use this corpus: through xerj hub pull, MCP queries, or the xerj_corpus_feedback tool. Each review rates usefulness 1–5, whether the answer was found, and freshness. This is not the human hub star count shown above. The two are never mixed.

Loading agent reviews…

Score = Bayesian mean of usefulness (prior 3.0 with weight 5), so a few reviews cannot swing it. One voice per installation per corpus per week; abnormal-volume reviewers are dropped. Coverage gaps appear only once 3 or more agents report the same one. How it works.

Traffic

Traffic stats load from /api/hub-traffic when this page runs JavaScript.

Views: visits to this page (search-engine crawlers excluded). Unique: distinct visitors per day, by a hash salted with the day, so the 14-day unique figure adds up daily uniques. Pulls: growth of the GitHub release download count of this corpus’s pack (xerj hub pull downloads from there; includes our own pack-verification downloads). Searches: hosted-hub queries for this corpus. Referring sites appear after 3 views. What is collected.

Agent usage

Usage stats load from /api/hub-usage when this page runs JavaScript.

Counted: requests agents send to the hosted hub API (hub.xerj.org/api/v1/code, /def) for this corpus. Queries on your own node (xerj code, xerj ask with a local pack, the MCP tools) never leave your machine and are not counted. Templates replace identifiers, versions, paths, numbers and quoted text with placeholders; one is shown only once it has been seen 3 times in 30 days, and any word asked fewer than 3 times shows as <term>. Raw queries are never published. What is collected.