{
  "markdown": "# SitePulsar MCP Server\n\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-ai.sitepulsar%2Fmcp-blue)](https://www.sitepulsar.ai/llms.txt)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)\n[![Transport: streamable-http](https://img.shields.io/badge/transport-streamable--http-purple)](https://mcp.sitepulsar.ai/mcp)\n\n> Agent Experience Optimization (AEO) for AI agents — measure and improve how findable, readable, and usable any website is to AI answer engines and autonomous AI agents, directly from your MCP client.\n\nA **remote, hosted** [Model Context Protocol](https://modelcontextprotocol.io) server. There is nothing to build or run locally — connect your MCP client to the hosted endpoint and the 13 tools below become available.\n\n**Endpoint (streamable-http):** `https://mcp.sitepulsar.ai/mcp`\n\n---\n\n## What is SitePulsar / AEO?\n\nSitePulsar is an **Agent Experience Optimization (AEO)** audit platform. It measures how findable, readable, and usable a website is to AI answer engines and autonomous AI agents, and returns one AEO score across three pillars:\n\n- **FIND** — discoverability across ChatGPT, Claude, Gemini, Perplexity, and Grok.\n- **READ** — comprehension, structured data, and trust signals.\n- **USE** — agent-actionability (can an autonomous AI agent actually take action on the site?).\n\nAEO is the agent-native successor to what used to be split as GEO + AIO. SitePulsar is agent infrastructure, not an SEO tool.\n\n---\n\n## Quick start\n\nThe server supports two auth modes. Pick whichever fits your client.\n\n### Option A — OAuth (recommended for Claude; no API key)\n\nAdd SitePulsar as a **custom connector** in Claude using the endpoint. Claude walks you through the OAuth handshake; no API key needs to be stored.\n\n- **Endpoint:** `https://mcp.sitepulsar.ai/mcp`\n- **OAuth protected-resource metadata:** `https://mcp.sitepulsar.ai/.well-known/oauth-protected-resource`\n\n### Option B — Bearer API key (for headless / non-interactive clients)\n\nMint an MCP API key in the [SitePulsar dashboard](https://www.sitepulsar.ai) (Pro/Business plan), then send it on every request:\n\n```\nAuthorization: Bearer <mcp_api_key>\n```\n\nSee [`examples/headless-curl.md`](./examples/headless-curl.md) for raw HTTP usage.\n\n---\n\n## Connect matrix\n\n| Client | How to connect |\n| --- | --- |\n| **Claude (desktop / web)** | Settings → Connectors → Add custom connector → paste `https://mcp.sitepulsar.ai/mcp`, then complete OAuth. |\n| **Claude Code (CLI)** | `claude mcp add --transport http sitepulsar https://mcp.sitepulsar.ai/mcp` |\n| **Cursor / Cline (JSON config)** | Add to your MCP config: see below. |\n\nCursor / Cline JSON config:\n\n```json\n{\n  \"mcpServers\": {\n    \"sitepulsar\": {\n      \"url\": \"https://mcp.sitepulsar.ai/mcp\"\n    }\n  }\n}\n```\n\nA ready-to-paste config is in [`examples/claude_desktop_config.json`](./examples/claude_desktop_config.json).\n\n> For headless clients that cannot do interactive OAuth, add an `Authorization: Bearer <mcp_api_key>` header (see Option B above).\n\n---\n\n## Tools\n\n13 tools, grouped by pillar coverage. \"Metered\" tools run a billed audit/scan and require a Pro/Business plan; \"Free\" tools are read-only or lightweight probes.\n\n| Tool | What it does | Cost |\n| --- | --- | --- |\n| `check_agent_readiness` | Fast synchronous agent-readiness check for a URL (no full run, no charge). Immediate signals on machine readability, structured data, and agent-accessibility. | Free |\n| `run_audit` | Start a full async AEO audit for a URL. Returns an `audit_id`; poll with `get_audit`. | Metered (Pro/Business) |\n| `get_audit` | Poll status and, when complete, a decision-ready summary: AEO score (overall + FIND/READ/USE), weakest pillar, headline takeaways, and top fixes. | Free |\n| `get_audit_detail` | Full per-section breakdown of a completed audit — per-dimension sub-scores, reputation across engines, competitor cluster, crawl/schema/robots, agentic + USE probes, rendered-DOM. | Free |\n| `get_audit_full` | One call returning summary + full detail + fixes (use `expand` to trim). | Free |\n| `compare_aeo` | Compare AEO posture across multiple URLs on the same pillar scale. | Free |\n| `get_fixes` | Prioritised, pillar-tagged action plan for a completed audit, ordered by estimated impact. | Free |\n| `search_companies` | Samples major AI engines for which companies they name for a query; returns a consensus shortlist (≤5). | Free |\n| `probe_agent_discovery` | Checks the official MCP registry, PyPI, and GitHub for servers/packages tied to a domain or brand. | Free |\n| `probe_mcp_functional` | Discovers a site's advertised MCP endpoint and reports its declared OAuth/transport posture + declared tool names. | Free |\n| `probe_ucp_readiness` | Inspects `/.well-known/ucp` for AI-shopping-agent transactability (presence + advertised capabilities). | Free |\n| `scan_visibility` | Live AI-visibility scan for any brand (crawl + reputation across engines): where a brand is mentioned. | Metered (Pro/Business) |\n| `scan_product_page` | Product-page readability scan for AI agents; structured product/offer extraction. | Free or metered — see dashboard |\n\nFull machine-readable tool reference: [`llms.txt`](https://www.sitepulsar.ai/llms.txt).\n\n---\n\n## Authentication\n\nSitePulsar accepts either of the following on the hosted endpoint.\n\n### OAuth\n\nUsed by interactive clients (e.g. Claude custom connectors). The server advertises its OAuth posture via RFC 9728 protected-resource metadata:\n\n```\nhttps://mcp.sitepulsar.ai/.well-known/oauth-protected-resource\n```\n\nYour client discovers the authorization server from that document and completes the handshake — no API key is stored on your side.\n\n### Bearer API key\n\nUsed by headless clients. Mint a key in the [SitePulsar dashboard](https://www.sitepulsar.ai) (Pro/Business plan) and send it on every request:\n\n```\nAuthorization: Bearer <mcp_api_key>\n```\n\nMetered tools (`run_audit`, `scan_visibility`, and the metered path of `scan_product_page`) require a Pro/Business plan regardless of auth mode.\n\n---\n\n## Links\n\n- Website: <https://www.sitepulsar.ai>\n- Tool reference (llms.txt): <https://www.sitepulsar.ai/llms.txt>\n- Hosted MCP endpoint: `https://mcp.sitepulsar.ai/mcp`\n- OAuth metadata: `https://mcp.sitepulsar.ai/.well-known/oauth-protected-resource`\n- Listed in the official MCP registry as `ai.sitepulsar/mcp` (v1.0.0).\n\n---\n\n## License\n\nMIT — see [`LICENSE`](./LICENSE).\n\n## Built by\n\n[SitePulsar](https://www.sitepulsar.ai) — EU-based (Netherlands). Founder & CEO: [Gijs van Bueren](https://www.linkedin.com/in/gijs-van-bueren-51b8263b2/). Questions: <info@sitepulsar.ai>.\n",
  "bytes": 6617,
  "sha": "91df4fe03ee7aa40aae5171cf1c23a2cc1f9d936d832f8b4654e09a3de4fce69",
  "repo_slug": "sitepulsar/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_sitepulsar_mcp_ddf0ee34/readme"
}