Realask - verified answers from the physical world

Official5 tools

by danelas

Ask a US local business a current question by phone. Typed, timestamped answers for agents; x402.

realask MCP Server (io.github.danelas/realask)

This MCP server provides a tool workflow to ask a US local business a current question by phone and return typed, timestamped answers for use by agents. It is associated with verification and agent interactions, and is identified as io.github.danelas/realask. The server reports toolCount: 5 and includes an excerpted description and topics.

🛠️ Key Features

Ask US local businesses current questions by phone
Return typed, timestamped answers for agents
Includes verification as a topic
toolCount: 5

🚀 Use Cases

Agent-driven verification involving local businesses
Agent workflows needing current, phone-sourced answers

⚡ Developer Benefits

Structured output for agent consumption (typed, timestamped answers)
Clear scope for MCP integration with a known tool set (toolCount: 5)

⚠️ Limitations

Limited context provided: only phone-based questions to US local businesses are described

Topics

agent-paymentsai-agentslocal-businessmcpmcp-serververificationx402

Captured live from the server via tools/list.

quote_real_world_answer

Get a free, immutable price quote for verifying a current fact about a US local business (stock, price, availability, capability, policy, wait time). Returns quote_id, price in integer minor units, scope, expected_completion_seconds and expires_at. Use purchase_quote to buy it.

Parameters5

request	string	required	Natural-language question, e.g. 'Does ABC Tire in 33312 have two Michelin Pilot Sport 4S 235/40R19 in stock today and what is the installed price?'
location	object	required
limits	object	optional
verification_mode	string	optional	auto reuses fresh cached facts when safe; live_verified forces a new call
callback_url	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "request": {
      "type": "string",
      "minLength": 8,
      "maxLength": 2000,
      "description": "Natural-language question, e.g. 'Does ABC Tire in 33312 have two Michelin Pilot Sport 4S 235/40R19 in stock today and what is the installed price?'"
    },
    "location": {
      "type": "object",
      "properties": {
        "postal_code": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "region": {
          "type": "string"
        },
        "country": {
          "default": "US",
          "type": "string"
        },
        "lat": {
          "type": "number"
        },
        "lng": {
          "type": "number"
        },
        "radius_miles": {
          "type": "number"
        }
      }
    },
    "limits": {
      "type": "object",
      "properties": {
        "max_businesses": {
          "type": "integer",
          "minimum": 1,
          "maximum": 5
        },
        "deadline_seconds": {
          "type": "integer",
          "minimum": 60,
          "maximum": 600
        },
        "max_call_attempts_per_target": {
          "type": "integer",
          "minimum": 1,
          "maximum": 2
        }
      }
    },
    "verification_mode": {
      "description": "auto reuses fresh cached facts when safe; live_verified forces a new call",
      "type": "string",
      "enum": [
        "digital_fast",
        "live_verified",
        "auto"
      ]
    },
    "callback_url": {
      "type": "string",
      "format": "uri"
    }
  },
  "required": [
    "request",
    "location"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

quote_real_world_action

Get a free price to ARRANGE something at a specific US local business: book an appointment, hold an item, request a formal quote, or cancel a prior booking. This creates a real obligation, so it needs explicit authorization, the customer's name and callback number, and a maximum price the caller may agree to. The caller never negotiates, never pays, and never substitutes something different. Purchase the returned quote with purchase_quote.

Parameters13

action	string	required
what	string	required	Exactly what to arrange, e.g. 'two Michelin Pilot Sport 4S 235/40R19 installed'
business_name	string	required	The business to act on
place_id	string	optional	Google place_id, if known - more reliable than a name
postal_code	string	required
when	string	optional	Time window, e.g. 'tomorrow afternoon'
quantity	integer	optional
max_price_minor	integer	optional	Ceiling in cents the caller may agree to. Required for book and hold.
customer_name	string	required	Name to hold the booking under. Shared with the business.
customer_callback_phone	string	required	Number the business can call back. Shared with the business.
reference	string	optional	Existing confirmation reference. Required for cancel.
notes	string	optional	Constraints the caller must honour
authorized	boolean	required	You confirm the end user authorized this commitment on their behalf

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "enum": [
        "book",
        "hold",
        "request_quote",
        "cancel"
      ]
    },
    "what": {
      "type": "string",
      "minLength": 3,
      "maxLength": 500,
      "description": "Exactly what to arrange, e.g. 'two Michelin Pilot Sport 4S 235/40R19 installed'"
    },
    "business_name": {
      "type": "string",
      "description": "The business to act on"
    },
    "place_id": {
      "description": "Google place_id, if known - more reliable than a name",
      "type": "string"
    },
    "postal_code": {
      "type": "string"
    },
    "when": {
      "description": "Time window, e.g. 'tomorrow afternoon'",
      "type": "string"
    },
    "quantity": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "max_price_minor": {
      "description": "Ceiling in cents the caller may agree to. Required for book and hold.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "customer_name": {
      "type": "string",
      "description": "Name to hold the booking under. Shared with the business."
    },
    "customer_callback_phone": {
      "type": "string",
      "description": "Number the business can call back. Shared with the business."
    },
    "reference": {
      "description": "Existing confirmation reference. Required for cancel.",
      "type": "string"
    },
    "notes": {
      "description": "Constraints the caller must honour",
      "type": "string"
    },
    "authorized": {
      "type": "boolean",
      "const": true,
      "description": "You confirm the end user authorized this commitment on their behalf"
    }
  },
  "required": [
    "action",
    "what",
    "business_name",
    "postal_code",
    "customer_name",
    "customer_callback_phone",
    "authorized"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

purchase_quote

The single purchase path: pays for a quote from EITHER quote_real_world_answer or quote_real_world_action and starts the job. There is no separate action-purchase tool. Returns job_id and job_token (keep it; it is shown once), then poll get_verification_status and read get_verification_result. If this server has no payment capability, returns the x402 payment requirements (HTTP 402 body) so you can pay with your own payment tool and retry the POST /v1/jobs request with a PAYMENT-SIGNATURE header.

Parameters2

quote_id	string	required
idempotency_key	string	optional	Client-generated UUID; reuse it when retrying

Raw schema

{
  "type": "object",
  "properties": {
    "quote_id": {
      "type": "string"
    },
    "idempotency_key": {
      "description": "Client-generated UUID; reuse it when retrying",
      "type": "string"
    }
  },
  "required": [
    "quote_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_verification_status

Read-only progress check on a job bought with purchase_quote. Free, changes nothing, and safe to call repeatedly. Returns the state plus a progress object (businesses discovered, call attempts made). States are queued, discovering, calling or extracting while the job is still running, and completed, partial, failed, timed_out or canceled once it is final. Poll every 15-30 seconds; live calls take minutes. Use this to decide WHEN to read the answer; use get_verification_result to read the answer itself. If you only intend to poll until the job is done, get_verification_result can be polled directly instead - it returns a provisional 202 until the job is final.

Parameters2

job_id	string	required	job_id returned by purchase_quote, e.g. 'job_gf8t5wwfrtgpjcdc'
job_token	string	required	job_token returned once by purchase_quote; the bearer token for this job. Not recoverable if lost - a new job would have to be purchased.

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "job_id returned by purchase_quote, e.g. 'job_gf8t5wwfrtgpjcdc'"
    },
    "job_token": {
      "type": "string",
      "description": "job_token returned once by purchase_quote; the bearer token for this job. Not recoverable if lost - a new job would have to be purchased."
    }
  },
  "required": [
    "job_id",
    "job_token"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_verification_result

Read-only. The answer itself: typed facts, evidence excerpts, timestamps, confidence scores, freshness, and an explicit list of what could not be verified. Free, and safe to call repeatedly. If the job is not final yet the response is provisional (http_status 202) - poll until 200, or watch get_verification_status for a terminal state first. A completed job answers every required criterion; a partial one answers some and says so in limitations.

Parameters2

job_id	string	required	job_id returned by purchase_quote, e.g. 'job_gf8t5wwfrtgpjcdc'
job_token	string	required	job_token returned once by purchase_quote; the bearer token for this job. Not recoverable if lost - a new job would have to be purchased.

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "job_id returned by purchase_quote, e.g. 'job_gf8t5wwfrtgpjcdc'"
    },
    "job_token": {
      "type": "string",
      "description": "job_token returned once by purchase_quote; the bearer token for this job. Not recoverable if lost - a new job would have to be purchased."
    }
  },
  "required": [
    "job_id",
    "job_token"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md3 KBView on GitHub

Realask MCP

Ask a US local business a current question by phone and get a typed, timestamped, confidence-scored answer back — not a transcript.

Realask is a paid MCP server and HTTP API for AI agents. When a fact changes faster than the web reflects it, or was never published at all — today's stock, a real all-in price, same-day availability, an edge-case capability, a policy exception, the current wait — an agent asks Realask, Realask calls the business, and the agent gets back structured facts with evidence, a timestamp, a confidence score, and an honest list of what could not be verified.

This repository is the public front door: the MCP manifest, connection details, and docs. The service itself is hosted at https://realask.net and is closed-source.

Website: https://realask.net
Machine docs: https://realask.net/llms.txt · https://realask.net/v1/capabilities · https://realask.net/openapi.json
Payment: https://realask.net/.well-known/x402
MCP registry: io.github.danelas/realask

Connect

Realask is a remote MCP server over streamable HTTP. Nothing to install.

json

{
  "mcpServers": {
    "realask": {
      "type": "streamable-http",
      "url": "https://realask.net/mcp"
    }
  }
}

Quoting is free and unauthenticated. Buying a quote requires payment (see below), so the purchase tool returns an x402 challenge to any agent that cannot pay for itself.

Tools

Tool	What it does
`quote_real_world_answer`	Free, immutable price quote for verifying a current fact about a US local business.
`quote_real_world_action`	Free price to arrange something — book, hold, request a quote, cancel. Requires explicit authorization, a customer name and callback number, and a price ceiling.
`purchase_quote`	The single purchase path for either kind of quote. Returns `job_id` + `job_token`.
`get_verification_status`	Job progress. Poll every 15–30s; live calls take minutes.
`get_verification_result`	The final answer: typed facts, evidence excerpts, timestamps, confidence, limitations.

Paying

Pricing is per job and quoted up front. Payment is x402 — exact scheme, USDC on Base (eip155:8453) — so a wallet-enabled agent pays inline:

code

POST /v1/quotes   ->  free: price, scope, expiry
POST /v1/jobs     ->  402 with payment requirements  ->  sign  ->  202 { job_id, job_token }
GET  /v1/jobs/{id}/result

Cached, recently verified answers are offered at a lower price; live_verified forces a fresh call. Full requirements: https://realask.net/.well-known/x402

What it will not do

Realask arranges and reserves; it never buys and never bargains.

Never negotiates, haggles, or asks for a discount
Never pays, and never gives card or bank details — the customer pays the business directly
Never agrees above the maximum price you set
Never substitutes a different item, time, or business than the one you specified
Shares only the customer name and callback number you supply, nothing else
Commits to exactly one business per job, and can never commit twice

No mass calling, no marketing calls, no call recordings.

For businesses

If we called you and you would rather we did not, press 1 during the call or use https://realask.net/opt-out. Businesses can also connect a live data feed so agents are answered from your own data, with you as the source, and we stop calling: https://realask.net/merchants

Questions: hello@realask.net · https://realask.net/privacy · https://realask.net/terms

Install

Tools (5)

quote_real_world_answerquote_real_world_actionpurchase_quoteget_verification_statusget_verification_result

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://realask.net/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "realask": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://realask.net/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

realask MCP Server (io.github.danelas/realask)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

quote_real_world_answer

quote_real_world_action

purchase_quote

get_verification_status

get_verification_result

Realask MCP

Connect

Tools

Paying

What it will not do

For businesses

Install

Remote endpoint

Related servers