# ⚡ AgentPulse MCP & Edge Intelligence API (`agentpulse-mcp`)

[![MCP Protocol](https://img.shields.io/badge/MCP-Streamable_HTTP_%2B_Stdio-0ea5e9)](https://agentpulse-mcp.scopeforge-studio.workers.dev/mcp)
[![OpenAPI 3.1](https://img.shields.io/badge/OpenAPI-3.1.0-10b981)](https://agentpulse-mcp.scopeforge-studio.workers.dev/openapi.json)
[![Live Playground](https://img.shields.io/badge/Playground-Live_on_Cloudflare_Edge-6366f1)](https://agentpulse-mcp.scopeforge-studio.workers.dev)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)

**AgentPulse** is a deterministic **Model Context Protocol (MCP) Server** and **REST API** running on the global Cloudflare Edge. It gives AI coding/research agents (**Claude Desktop, Cursor, Windsurf, Cline**) and automation pipelines (**Clay.com, n8n, Make, Zapier**) real-time B2B domain intelligence, 2026 AI Search (`llms.txt` / AEO) auditing, clean URL-to-Markdown conversion, and DNS/DMARC security inspection.

🔗 **Live Playground & Instant API Key Portal:** [https://agentpulse-mcp.scopeforge-studio.workers.dev](https://agentpulse-mcp.scopeforge-studio.workers.dev)  
🔌 **Remote MCP Endpoint (Zero Install):** `https://agentpulse-mcp.scopeforge-studio.workers.dev/mcp`

---

## 🛠️ 5 Deterministic Tools Included

| Tool Name | REST Endpoint | What It Does |
| :--- | :--- | :--- |
| **`enrich_company_domain`** | `GET /api/v1/enrich?domain=linear.app` | Crawls homepage, `/contact`, `/about`, `/pricing`, and `/llms.txt` in parallel. Extracts role-categorized emails, phone numbers, social links (LinkedIn, X, GitHub, YouTube), **35+ tech stack signatures** (Shopify, Next.js, Stripe, GA4, Segment, PostHog, RB2B, Intercom, HubSpot), compliance badges (`SOC 2`, `HIPAA`, `GDPR`), and B2B buying signals. |
| **`audit_ai_search_readiness`** | `GET /api/v1/aeo-audit?domain=stripe.com` | **2026 AI Search / Answer Engine Optimization (AEO & GEO) Auditor.** Scores any domain `0-100` (`A+` to `F`) across `/llms.txt`, `/llms-full.txt`, `robots.txt` rules for 8 AI bots (`GPTBot`, `OAI-SearchBot`, `ClaudeBot`, `PerplexityBot`, `Google-Extended`), `Schema.org` JSON-LD entities, and **auto-generates a ready-to-deploy `/llms.txt` file + JSON-LD snippet**. |
| **`extract_clean_markdown`** | `GET /api/v1/markdown?url=https://...` | Converts any live web page into clean, token-efficient GitHub-Flavored Markdown with YAML frontmatter (`title`, `description`, `source_url`, `estimatedAgentTokens`, `tokenSavingsPercent`). |
| **`inspect_domain_infra`** | `GET /api/v1/dns-infra?domain=openai.com` | Queries Cloudflare DNS-over-HTTPS (`1.1.1.1`) for `A`, `MX`, `TXT`, `SPF`, `_dmarc`, `NS`, and `CAA`. Identifies the exact email provider, checks DMARC/SPF spoofing vulnerability, audits HTTP security headers, and extracts **Verified Enterprise SaaS footprints from DNS TXT records** (OpenAI, Anthropic, Stripe, Slack, Atlassian, HubSpot, Microsoft 365). |
| **`batch_enrich_domains`** | `POST /api/v1/batch` | High-concurrency parallel enrichment/AEO/DNS pipeline for up to **25 domains per request** *(Requires Growth Pro or Agency Scale API Key)*. |

---

## 🚀 Quick Connect (Claude Desktop, Cursor, Windsurf, Cline)

### Option A: Direct Remote MCP URL (Zero Local Install)
Add this to your `claude_desktop_config.json` or `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "agentpulse": {
      "url": "https://agentpulse-mcp.scopeforge-studio.workers.dev/mcp"
    }
  }
}
```

*(With a Pro API key, append `?api_key=agp_live_YOUR_KEY` to the URL).*

### Option B: Local `stdio` Bridge
If your MCP client prefers `stdio` command execution:

```json
{
  "mcpServers": {
    "agentpulse": {
      "command": "npx",
      "args": ["-y", "github:sonofkratos92/agentpulse-mcp"],
      "env": {
        "AGENTPULSE_API_KEY": "agp_live_optional_pro_key"
      }
    }
  }
}
```

---

## ⚡ Rate Limits & Instant Self-Serve Credit Packs

- **Free Sandbox Tier:** **15 free single-domain calls per day per IP** — zero signup or API key required.
- **Instant Self-Serve Credit Packs (Credits Never Expire):**
  - **[Starter Pack ($9 one-time — 2,500 Credits)](https://buy.stripe.com/7sY6oI4Bk1EM8EG1in6kg07)**
  - **[Growth Pro Pack ($29 one-time — 15,000 Credits + Bulk Batch API)](https://buy.stripe.com/aFa9AU0l4cjq9IK1in6kg08)**
  - **[Agency Scale Pack ($79 one-time — 100,000 Credits + High Concurrency)](https://buy.stripe.com/dRmdRaaZIerydZ01in6kg09)**

The moment Stripe Checkout finishes, you are automatically redirected back to `https://agentpulse-mcp.scopeforge-studio.workers.dev/?session_id={CHECKOUT_SESSION_ID}` where your `agp_live_...` key is verified and minted on screen in under 2 seconds.