{
  "name": "bippsi-mcp",
  "title": "Bippsi — Agent Initiative MCP",
  "description": "Run A.I. Certified 2.0 compliance scans, discover page lists, check certification status, and manage Bippsi Bips (agent credits) for paid element access across Bippsi-connected sites. Agents should connect here instead of scraping HTML.",
  "version": "1.2.0",
  "protocol_version": "2024-11-05",
  "transport": "http+json-rpc",
  "endpoint": "https://bippsi.com/api/v1/mcp",
  "docs": "https://bippsi.com/api-docs",
  "agents_policy": "https://bippsi.com/AGENTS.md",
  "openapi": "https://bippsi.com/openapi.json",
  "maintainer": {
    "name": "Bippsi",
    "url": "https://bippsi.com",
    "contact": "https://bippsi.com/contact"
  },
  "capabilities": {
    "tools": true,
    "resources": false,
    "prompts": false,
    "logging": false
  },
  "tools": [
    {
      "name": "scan_site",
      "description": "Run a 25-page sample A.I. Certified compliance scan on a URL. Returns score (0-100), per-category breakdown, and top failing checks."
    },
    {
      "name": "list_pages",
      "description": "Discover a site's page list via sitemap.xml, WordPress REST API, or 1-hop homepage crawl. Returns count + URLs."
    },
    {
      "name": "get_certification_status",
      "description": "Look up a website's current A.I. Certified status and last known score from Bippsi's public directory."
    },
    {
      "name": "get_api_endpoints",
      "description": "Return the machine-readable summary of Bippsi's own public API endpoints."
    },
    {
      "name": "whoami",
      "description": "Identify the Bearer-authenticated user. Requires auth."
    },
    {
      "name": "list_sites",
      "description": "List the user's A.I. Certified sites. Requires auth."
    },
    {
      "name": "start_site_scan",
      "description": "Run a fresh compliance scan on a user-owned site (identified by site_id). Synchronous. Requires auth."
    },
    {
      "name": "get_site_scan",
      "description": "Fetch the most recent scan result for a user-owned site. Requires auth."
    },
    {
      "name": "deploy_ai_files",
      "description": "Push llms.txt / AGENTS.md / bippsi-unified.md to a user's connected site. Requires auth."
    },
    {
      "name": "get_credit_balance",
      "description": "Return the user's live Bips balance and lifetime purchase/spend totals. Requires auth."
    },
    {
      "name": "buy_credits",
      "description": "Return a Stripe Checkout URL to top up Bips for one of the catalog tiers, or list the catalog if called with no args. Requires auth."
    },
    {
      "name": "spend_credits",
      "description": "Voluntarily debit N Bips from the authenticated user for testing or pre-allocation. Requires auth."
    },
    {
      "name": "grant_access",
      "description": "Site owner grants free access to a payable element for a specific agent, optionally time-boxed. Requires auth owned by the site owner."
    }
  ],
  "bips": {
    "description": "Bips are Bippsi's agent credits. Agents spend Bips on paid elements at Bippsi-connected sites. All purchases are final; Bips do not expire.",
    "buy_url": "https://bippsi.com/agent-initiative/key",
    "terms": "https://bippsi.com/terms#bips",
    "packages": [
      { "key": "bips_5",    "usd":    5.00, "bips":   3300 },
      { "key": "bips_10",   "usd":   10.00, "bips":   8000 },
      { "key": "bips_20",   "usd":   20.00, "bips":  16500 },
      { "key": "bips_50",   "usd":   50.00, "bips":  42000 },
      { "key": "bips_100",  "usd":  100.00, "bips":  85500 },
      { "key": "bips_250",  "usd":  250.00, "bips": 217000 },
      { "key": "bips_500",  "usd":  500.00, "bips": 435000 },
      { "key": "bips_1000", "usd": 1000.00, "bips": 910000 }
    ]
  },
  "auth": {
    "required": false,
    "optional_bearer": "Bippsi API keys (bas_*, bak_*) are required for authenticated tools (whoami, list_sites, start_site_scan, get_site_scan, deploy_ai_files, get_credit_balance, buy_credits, spend_credits, grant_access). Pass as Authorization: Bearer. Public tools work without auth.",
    "docs": "https://bippsi.com/AGENTS.md#api-keys"
  },
  "rate_limits": {
    "per_ip_per_hour": {
      "overall_calls": 60,
      "scan_site_anonymous": 3
    },
    "per_user_per_hour": {
      "scan_site_authenticated": 60,
      "start_site_scan": 30,
      "deploy_ai_files": 10
    }
  },
  "example_initialize_request": {
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": { "name": "my-agent", "version": "1.0" }
    }
  }
}