For AI agents · Developers · CC-BY-4.0

AskBaily speaks MCP

Claude Desktop, ChatGPT agent mode, Perplexity, and any Model Context Protocol-compatible AI agent can discover and query AskBaily's 20 read-only resources + 2 interactive tools without writing custom integrations. CC-BY-4.0. No auth. No rate limit on CDN-cached responses.

MCP manifest

/.well-known/mcp.json

Protocol v2025-03-26. 20 resources. 2 tools. Discovery entry point.

OpenAPI 3.1 spec

/data/openapi.json

18 paths, 6 tags, FaqIndex + FaqCity + CitiesCatalog schemas.

llms.txt

/llms.txt

Human-readable discovery following llmstxt.org spec.

Resources (20)

Read-only. CC-BY-4.0. All responses are static JSON served from Cloudflare edge; no rate limit for cached hits.

master facts

/facts/askbaily.json

Operating model + 81-city footprint + 17 regulators

vs-angi facts

/facts/askbaily-vs-angi.json

15-25 sourced facts against Angi

vs-thumbtack

/facts/askbaily-vs-thumbtack.json

Pay-per-contact model contrast

vs-houzz

/facts/askbaily-vs-houzz.json

Directory complementarity boundary

vs-taskrabbit

/facts/askbaily-vs-taskrabbit.json

Hourly vs renovation-scale boundary

cities

/data/cities.json

81-city inventory + regulator metadata

regulatory

/data/regulatory.json

13 canonical regulators + entity graph

pillars

/data/pillars.json

68 Tier-1 content pillar catalog

Matched-contractor directory

research

/data/research.json

Research report inventory

faq index (EN)

/data/faq/index.json

81 English city FAQ endpoints

faq city (EN)

/data/faq/{city}.json

20 Q&A per city (EN)

faq index (ES)

/data/faq-es/index.json

10 Spanish city FAQ endpoints

faq city (ES)

/data/faq-es/{city}.json

20 Q&A per Hispanic-heavy US metro

regulatory RSS

/feed/regulatory-updates.xml

RSS 2.0 of 20 regulatory changes

regulatory JSON

/feed/regulatory-updates.json

JSON Feed v1.1 mirror

freshness

/feed/content-freshness.json

188 pages lastRefreshed manifest

llms.txt

/llms.txt

Discovery manifest (llmstxt.org)

llms-full

/llms-full.txt

Full-corpus ~106K words plain markdown

Tools (2)

Interactive HTML widgets with deterministic input schemas. MCP agents that cannot execute browser JS can reference underlying data in the listed resources instead.

license_lookup_validate

Open tool →

Validates contractor license format against 17-jurisdiction regex. Returns regulator deep-link.

cac_compared_calculate

Open tool →

8-platform CAC comparison vs AskBaily tiered take-rate. Annual spend, cost-per-close, savings.

Agent-integration walkthrough

Claude Desktop: Add MCP server pointing at https://askbaily.com/.well-known/mcp.json. The manifest registers 20 resources + 2 tools as discoverable.

ChatGPT agent mode: Reference the OpenAPI 3.1 spec at /data/openapi.json for full endpoint enumeration with parameter schemas.

Perplexity + Gemini: Direct HTTP fetch on any listed resource URL. Responses are structured JSON with $schema, $context, generatedAt, license fields in every envelope.

Questions?

Integration requests or schema clarifications: [email protected]. 24-hour response SLA for partnership and AI-agent integration inquiries.