{
  "$schema": "https://modelcontextprotocol.io/schemas/draft/2025/server-card.json",
  "serverInfo": {
    "name": "ai.surfpay.integration-brief",
    "title": "surfpay.ai, Surfboard Payments integration brief",
    "version": "1.0.0",
    "description": "MCP server carrying the Surfboard Payments integration brief and the agent skills pack: what to build, in what order, and the guides that back it."
  },
  "endpoint": "https://surfpay.ai/.well-known/mcp",
  "protocolVersion": "2025-06-18",
  "transports": [
    {
      "type": "streamable-http",
      "url": "https://surfpay.ai/.well-known/mcp",
      "description": "Hosted, stateless, no install and no credentials. POST a JSON-RPC message; the response comes back as JSON rather than an SSE stream, and no session header is issued or required."
    }
  ],
  "capabilities": {
    "tools": [
      {
        "name": "get_integration_brief",
        "description": "Return the full, official instructions for integrating Surfboard Payments into a codebase: the skills to install, the documentation to connect, the credentials step that belongs to the user, and the Demo transaction to finish on. Call this first, before any other tool here, whenever the task is \"add payments\" or mentions Surfboard."
      },
      {
        "name": "list_skills",
        "description": "List every skill in the Surfboard Payments skills pack with its description, the guides it bundles, and a SHA-256 of its contents. Use this to decide which skill covers the integration in front of you before fetching one."
      },
      {
        "name": "get_skill",
        "description": "Return the complete SKILL.md for one skill: the procedure, the ordering, the failure modes, and what \"done\" looks like for that integration. Start with \"surfboard-payments\", the router, which carries the conventions every other skill assumes."
      },
      {
        "name": "search_docs",
        "description": "Keyword search across the skills pack and the 41 developer guides it bundles. Good for \"how does X work\" questions about a flow: receipts, tips, refunds, webhooks, Tap to Pay, recurring billing. For a specific API endpoint or webhook event, use the documentation MCP at https://www.surfboardpayments.com/.well-known/mcp instead, which indexes all 157 endpoints."
      },
      {
        "name": "get_guide",
        "description": "Return the full markdown of one developer guide by slug, as bundled with the skills pack. Slugs come from search_docs or list_skills, e.g. \"create-an-order\", \"webhooks-notifications\", \"tap-to-pay-iphone\"."
      }
    ],
    "resources": [],
    "prompts": []
  },
  "relatedServers": [
    {
      "name": "com.surfboardpayments.surf-mcp",
      "description": "The API documentation server: 157 endpoints, 44 guides, and the webhook event catalog. Connect this as well when writing request payloads.",
      "endpoint": "https://www.surfboardpayments.com/.well-known/mcp",
      "transport": "streamable-http",
      "npm": "https://www.npmjs.com/package/@surfboardpayments/surf-mcp"
    }
  ],
  "documentation": "https://surfpay.ai/docs",
  "agentInstructions": "https://surfpay.ai/agent-instructions.md",
  "openapi": "https://surfpay.ai/openapi.json",
  "paymentsOpenapi": "https://www.surfboardpayments.com/openapi/carbon.json",
  "version": "1.0.0",
  "homepage": "https://surfpay.ai"
}