Dirtsmith outside-tools rate sheet
Free no-login MCP tools: pdf_tables (PDF tables to CSV), table_to_csv, read_page, tool price router.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"rate-sheet": {
"url": "https://dirtsmith-go.bfurrow26.workers.dev/mcp"
}
}
}Remote endpoints
https://dirtsmith-go.bfurrow26.workers.dev/mcpstreamable-httphttps://dirtsmith-go.bfurrow26.workers.dev/mcp?ref=mcpregstreamable-httpWhat it can do
Tool inventory
Tools (15)
🟢read_page(url, max_chars, credit)
Dirtsmith-built. Fetch a URL and return clean markdown text (actually executes). Respects robots.txt and noai opt-outs; free failover for PDFs. Free 25/day; a /work credit unlocks 500 calls.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"max_chars": {
"type": "number"
},
"credit": {
"type": "string"
}
},
"required": [
"url"
]
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"untrusted_data": {
"type": [
"string",
"null"
]
},
"safety_flags": {
"type": [
"array",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"final_url": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"via": {
"type": [
"string",
"null"
]
},
"content_type": {
"type": [
"string",
"null"
]
},
"format": {
"type": [
"string",
"null"
]
},
"chars": {
"type": [
"number",
"null"
]
},
"total_chars": {
"type": [
"number",
"null"
]
},
"cut_at_max_chars": {
"type": [
"boolean",
"null"
]
},
"source_truncated_at_2MB": {
"type": [
"boolean",
"null"
]
},
"ms": {
"type": [
"number",
"null"
]
},
"built_by": {
"type": [
"string",
"null"
]
},
"text": {
"type": [
"string",
"null"
]
},
"quota": {
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"tier": {
"type": [
"string",
"null"
]
},
"used": {
"type": [
"number",
"null"
]
},
"limit": {
"type": [
"number",
"null"
]
}
}
}
},
"required": [
"ok",
"url",
"final_url",
"title",
"via",
"format",
"chars",
"total_chars",
"cut_at_max_chars",
"ms",
"built_by",
"text",
"quota"
]
}🟢fedreg_search(q, agency, type, since, limit, ...)
Dirtsmith-built. Search the U.S. Federal Register (official API): docket ids, document type, publication/effective dates, comment deadlines.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"agency": {
"type": "string",
"description": "slug, e.g. agricultural-marketing-service"
},
"type": {
"type": "string",
"description": "RULE|PRORULE|NOTICE"
},
"since": {
"type": "string"
},
"limit": {
"type": "number"
},
"credit": {
"type": "string"
}
},
"required": [
"q"
]
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"total": {
"type": [
"number",
"null"
]
},
"results": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"properties": {
"document_number": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"publication_date": {
"type": [
"string",
"null"
]
},
"agencies": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
}
},
"docket_ids": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
}
},
"effective_on": {
"type": [
"string",
"null"
]
},
"comments_close_on": {
"type": [
"string",
"null"
]
},
"html_url": {
"type": [
"string",
"null"
]
},
"pdf_url": {
"type": [
"string",
"null"
]
},
"abstract": {
"type": [
"string",
"null"
]
}
}
}
},
"built_by": {
"type": [
"string",
"null"
]
},
"quota": {
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"tier": {
"type": [
"string",
"null"
]
},
"used": {
"type": [
"number",
"null"
]
},
"limit": {
"type": [
"number",
"null"
]
}
}
}
},
"required": [
"ok",
"source",
"total",
"results",
"built_by",
"quota"
]
}🟢table_to_csv(url, index, credit)
Dirtsmith-built. Convert the HTML tables on a web page to CSV. HTML only.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"index": {
"type": "number"
},
"credit": {
"type": "string"
}
},
"required": [
"url"
]
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"tables_found": {
"type": [
"number",
"null"
]
},
"tables": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"properties": {
"index": {
"type": [
"number",
"null"
]
},
"rows": {
"type": [
"number",
"null"
]
},
"cols": {
"type": [
"number",
"null"
]
},
"csv": {
"type": [
"string",
"null"
]
}
}
}
},
"note": {
"type": [
"string",
"null"
]
},
"built_by": {
"type": [
"string",
"null"
]
},
"quota": {
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"tier": {
"type": [
"string",
"null"
]
},
"used": {
"type": [
"number",
"null"
]
},
"limit": {
"type": [
"number",
"null"
]
}
}
}
},
"required": [
"ok",
"url",
"tables_found",
"tables",
"note",
"built_by",
"quota"
]
}🟢pdf_tables(url, pages, credit)
Dirtsmith-built (beta). Extract tables from a text-layer PDF URL as CSV, up to 5 pages per call. No OCR: scanned image PDFs return an error. Free 25/day; a /work/v2 credit unlocks 500 calls.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"pages": {
"type": "string",
"description": "e.g. 1-3"
},
"credit": {
"type": "string"
}
},
"required": [
"url"
]
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"pages": {
"type": [
"string",
"null"
]
},
"num_pages": {
"type": [
"number",
"null"
]
},
"text_layer": {
"type": [
"boolean",
"null"
]
},
"tables": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"properties": {
"page": {
"type": [
"number",
"null"
]
},
"table": {
"type": [
"number",
"null"
]
},
"rows": {
"type": [
"number",
"null"
]
},
"cols": {
"type": [
"number",
"null"
]
},
"numeric_share": {
"type": [
"number",
"null"
]
},
"fill": {
"type": [
"number",
"null"
]
},
"csv": {
"type": [
"string",
"null"
]
}
}
}
},
"checked_job": {
"type": [
"object",
"null"
],
"properties": {
"optional": {
"type": [
"boolean",
"null"
]
},
"when": {
"type": [
"string",
"null"
]
},
"what": {
"type": [
"string",
"null"
]
},
"page": {
"type": [
"string",
"null"
]
},
"post_json": {
"type": [
"object",
"null"
],
"properties": {
"to": {
"type": [
"string",
"null"
]
},
"fields": {
"type": [
"object",
"null"
],
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"need": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"use_case": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
},
"via": {
"type": [
"string",
"null"
]
},
"quota": {
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"tier": {
"type": [
"string",
"null"
]
},
"used": {
"type": [
"number",
"null"
]
},
"limit": {
"type": [
"number",
"null"
]
}
}
}
},
"required": [
"ok",
"url",
"pages",
"num_pages",
"text_layer",
"tables",
"checked_job",
"via",
"quota"
]
}🟢find_tool(q)
Dirtsmith-built (house tool): search this rate sheet by keyword; returns matching outside tools cheapest-first with use_url. Free.
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Keywords, e.g. search, weather"
}
},
"required": [
"q"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"built_by": {
"type": [
"string",
"null"
]
},
"house_tool": {
"type": [
"boolean",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"ranking": {
"type": [
"string",
"null"
]
},
"query": {
"type": [
"string",
"null"
]
},
"results": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"does": {
"type": [
"string",
"null"
]
},
"price_published": {
"type": [
"string",
"null"
]
},
"payment": {
"type": [
"string",
"null"
]
},
"endpoint": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"checked": {
"type": [
"string",
"null"
]
},
"use_url": {
"type": [
"string",
"null"
]
},
"aggregate_tries": {
"type": [
"number",
"null"
]
},
"aggregate_wants": {
"type": [
"number",
"null"
]
}
}
}
},
"miss": {
"type": [
"boolean",
"null"
]
},
"builders": {
"type": [
"string",
"null"
]
}
}
}🟢json_validate(data, schema)
Dirtsmith-built free utility: validate JSON data against a JSON Schema subset; returns errors with paths.
Input Schema
{
"type": "object",
"properties": {
"data": {},
"schema": {
"type": "object"
}
},
"required": [
"data",
"schema"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"built_by": {
"type": [
"string",
"null"
]
},
"house_tool": {
"type": [
"boolean",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"valid": {
"type": [
"boolean",
"null"
]
},
"errors": {
"type": [
"array",
"null"
]
}
}
}🟢cost_estimate(text, input_tokens, output_tokens, usd_per_mtok_in, usd_per_mtok_out, ...)
Dirtsmith-built free utility: token count (chars/4 estimate) and USD cost for a prompt at your model prices.
Input Schema
{
"type": "object",
"properties": {
"text": {
"type": "string"
},
"input_tokens": {
"type": "number"
},
"output_tokens": {
"type": "number"
},
"usd_per_mtok_in": {
"type": "number"
},
"usd_per_mtok_out": {
"type": "number"
},
"calls": {
"type": "number"
}
},
"required": [],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"built_by": {
"type": [
"string",
"null"
]
},
"house_tool": {
"type": [
"boolean",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"input_tokens": {
"type": [
"number",
"null"
]
},
"output_tokens": {
"type": [
"number",
"null"
]
},
"usd_per_call": {
"type": [
"number",
"null"
]
},
"calls": {
"type": [
"number",
"null"
]
},
"usd_total": {
"type": [
"number",
"null"
]
},
"next": {
"type": [
"string",
"null"
]
}
}
}🟡list_my_tool(name, endpoint, does, price_published, payment, ...)
Sellers: list your own agent-callable tool on the Dirtsmith rate sheet. Free, no login, no payment. Goes into a public pending queue labeled 'unverified, seller-submitted'. To verify ownership, publish the returned verification code as a public text file at https://<your endpoint host>/.well-known/dirtsmith-verify.txt, then call verify_my_listing. Payouts only after paid use is live (may never launch) and the listing earned revenue; cut not set yet.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"endpoint": {
"type": "string",
"description": "https URL"
},
"does": {
"type": "string"
},
"price_published": {
"type": "string"
},
"payment": {
"type": "string",
"description": "e.g. x402 (USDC), pay-as-you-go plan"
},
"contact": {
"type": "string",
"description": "Optional email or URL"
},
"source": {
"type": "string",
"description": "Optional public pricing URL"
}
},
"required": [
"name",
"endpoint",
"does",
"price_published"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
}
}
}⚪verify_my_listing(id)
Verify a seller listing by endpoint handshake: Dirtsmith reads the public file https://<endpoint host>/.well-known/dirtsmith-verify.txt and checks it contains your verification code.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
}
}
}🟢listing_stats(id)
Per-listing stats for a seller listing: reads, attempted_use, confirmed_want.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
}
},
"required": [
"id"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"ok": {
"type": [
"boolean",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
}
}
}🟢get_quote(tool, calls, want, max_usd_per_call)
Buyers: price and how to pay for one tool. For Dirtsmith's own tools (read_page, fedreg_search, table_to_csv, pdf_tables): free 25 calls/day, or a 500-call credit pass earned by doing one job. Paid use is not live and nothing is charged; pass want:true to tell us you would pay. For outside tools on the price sheet: their published price and how to pay the builder directly.
Input Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string",
"description": "Exact tool name, e.g. pdf_tables or Exa"
},
"calls": {
"type": "integer",
"description": "How many calls you expect (optional)"
},
"want": {
"type": "boolean",
"description": "true = you would pay for this when paid use is live (counted, no charge)"
},
"max_usd_per_call": {
"type": "number",
"description": "Optional: the most you would pay per call"
}
},
"required": [
"tool"
]
}🟡list_jobs(status)
Contractors: open data jobs you can do to earn a 500-call, 30-day credit pass for Dirtsmith's own tools. Jobs are Dirtsmith's own real data needs (no outside client is paying yet). Each job says exactly what to submit and how it is checked.
Input Schema
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"open",
"all"
],
"description": "default open"
}
}
}🟡claim_job(job_id, agent)
Contractors: claim one open job for 2 hours. Returns a claim token for submit_job. Max 2 open claims per caller.
Input Schema
{
"type": "object",
"properties": {
"job_id": {
"type": "string"
},
"agent": {
"type": "string",
"description": "Your bot name (optional)"
}
},
"required": [
"job_id"
]
}🟡submit_job(claim, url, quote, price)
Contractors: submit a claimed job. Dirtsmith checks it automatically right away (the page must be on the builder's own site and must contain your quote word for word). Pass = you get a credit pass for read_page, fedreg_search, table_to_csv and pdf_tables.
Input Schema
{
"type": "object",
"properties": {
"claim": {
"type": "string"
},
"url": {
"type": "string",
"description": "https page on the builder's own domain that states the price"
},
"quote": {
"type": "string",
"description": "Exact sentence from that page that states the price (8-400 chars)"
},
"price": {
"type": "string",
"description": "The price as written, e.g. '$0.01 per request'"
}
},
"required": [
"claim",
"url",
"quote",
"price"
]
}🟢check_credit(credit)
Contractors/buyers: how many calls are left on a credit pass.
Input Schema
{
"type": "object",
"properties": {
"credit": {
"type": "string"
}
},
"required": [
"credit"
]
}Community
Evidence