For AI agents

Faro MCP Server

A free, unauthenticated Model Context Protocol server. Five tools that let an agent search a registry of companies scored for agent-readiness, look one up, find substitutes, or scan any website live. No API key and no sign-up.

Connect

Point any MCP client at the endpoint below. It speaks Streamable HTTP, so no local process or stdio bridge is needed.

{
  "mcpServers": {
    "faro": {
      "type": "streamable-http",
      "url": "https://byfaro.ai/mcp"
    }
  }
}

Endpointhttps://byfaro.ai/mcp

TransportStreamable HTTP (JSON-RPC 2.0 over POST)

Protocol versions2025-06-18, 2025-03-26, 2024-11-05

AuthenticationNone. All five tools are free and public.

Tool annotationsAll five are readOnlyHint: true. Nothing mutates state.

Rate limitingPer IP, on scan_website only.

Tools

Five tools, all read-only. Full JSON Schemas come back from tools/list; the summary below is for humans deciding whether to connect.

search_businessesSearch the Agent Registry

Find companies filtered by machine-readable capability: public API docs, llms.txt, an MCP server, structured pricing, AI-crawler permission, minimum score.

Arguments: q, min_score, has_api, has_llms_txt, has_mcp, has_pricing, allows_ai, limit · Required: none

find_alternativesFind agent-ready alternatives

Given a domain, return comparable companies with an equal or higher AI-readiness score. Check reference_found: when false the domain is not in the registry and the results are the highest-scoring companies overall rather than alternatives matched to it.

Arguments: domain, min_score, limit · Required: domain

get_business_profileGet a company's readiness profile

Look up one domain: score, grade, every capability flag, and when Faro last verified it.

Arguments: domain · Required: domain

scan_websiteScan a website for AI readiness

Run a live audit on any URL. Returns a 0-100 score, an A-F grade, and a check-by-check breakdown across 7 categories with prioritised fix instructions.

Arguments: url · Required: url

get_score_indexGet the public Score Index

The public leaderboard of AI-readiness scores for well-known websites, refreshed daily. For benchmarks and category context.

Arguments: limit · Required: none

Example calls

List the tools

curl -s -X POST https://byfaro.ai/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Find vendors an agent can integrate with

curl -s -X POST https://byfaro.ai/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search_businesses",
                 "arguments":{"has_api":true,"has_mcp":true,"min_score":70,"limit":5}}}'

Scan a site that is not in the registry

curl -s -X POST https://byfaro.ai/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"scan_website","arguments":{"url":"https://example.com"}}}'

A GET on the same endpoint returns a plain descriptor (server info, supported protocol versions, and the tool list) for agents probing the URL before speaking JSON-RPC.

Protocol versions

The server implements 2025-06-18, 2025-03-26 and 2024-11-05. On initialize it echoes back the version you asked for when it is one of those, and otherwise answers with 2025-06-18, the newest it speaks.

curl -s -X POST https://byfaro.ai/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"my-agent","version":"1.0"}}}'

// -> {"protocolVersion":"2025-06-18","serverInfo":{"name":"faro-ai-readiness",...}}

Registry API (REST)

The same registry is queryable over plain HTTP, no key required, if you would rather not speak MCP. Same filters as search_businesses.

GET https://byfaro.ai/api/v1/registry?has_api=true&min_score=70&limit=5

The Agency-plan REST API for bulk scanning and white-label reporting is documented separately, inside the dashboard. See pricing.

Discovery files

Everything an agent needs to find Faro on its own:

/.well-known/mcp.jsonMCP server card: endpoint, transport, tools

/.well-known/mcp/server-card.jsonServer card in the newer nested location

/.well-known/agent.jsonAgent manifest

/.well-known/payx402 payment endpoint

/llms.txtPlain-text site summary for LLMs

/openapi.jsonOpenAPI description of the public scan API

Support and policies

Questions, or a problem with a tool response: hello@byfaro.ai · Privacy policy · Terms · Browse the registry