Pulse MCP Server

A Model Context Protocol (MCP) server that provides comprehensive tools for integrating Refund Protect's Pulse platform across different implementation approaches - React components, JavaScript widgets, and direct API integration.

Created and maintained by the Protect Group Tech Team.

What is Model Context Protocol (MCP)

Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. It provides a standardized way for AI models to access and interact with various systems.

MCP servers act as intermediaries that expose specific functionalities to AI assistants through a well-defined protocol, allowing for seamless integration of external tools and data sources into AI workflows.

Important Notice

This MCP server generates code for guidance and understanding purposes only. The generated code is NOT production-ready and should not be used directly in production environments.

All partners and developers must:

• Follow the official Pulse integration documentation for production implementations
• Work with the Protect Group partnership team for proper integration support
• Validate all generated code against official documentation before implementation

Official Documentation:

• Pulse Widget Integration Guide
• Pulse React Integration Guide
• Pulse API Documentation

For partnership support and production guidance, contact the Protect Group partnership team.

Configure Pulse MCP in your AI client

Pulse MCP server is compatible with various AI development environments. Each platform provides unique benefits for Pulse platform integration.

VS Code

VS Code integration works through compatible extensions and MCP-enabled AI tools.

Configuration:

1. Install VS Code and relevant AI extensions (GitHub Copilot, etc.)
2. Add Pulse MCP server to your workspace (.vscode/mcp.json)

{
  "servers": {
    "pulse-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@abelpenton_dev/pulse-mcp-server"
      ],
      "type": "stdio"
    }
  },
}

Claude Desktop

Claude Desktop provides conversational AI assistance with full MCP integration.

Configuration:

1. Download and install Claude Desktop
2. Open Claude Desktop and go to Settings
3. Navigate to the Developer section
4. Click "Edit Config" to open claude_desktop_config.json
5. Add the Pulse MCP server configuration:

{
  "mcpServers": {
    "pulse-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@abelpenton_dev/pulse-mcp-server"
      ],
      "type": "stdio"
    }
  }
}

6. Restart Claude Desktop

Cursor

Cursor IDE integrates MCP servers directly into your development workflow for contextual code assistance.

Configuration:

1. Download and install Cursor IDE
2. Open Cursor and navigate to MCP Settings
3. Click "Add new global MCP Server"
4. Add the configuration to your mcp.json file:

{
  "mcpServers": {
    "pulse-mcp-server": {
      "command": "npx",
      "args": ["-y", "@abelpenton_dev/pulse-mcp-server"]
    }
  }
}

5. Open the chat interface with Ctrl + I (or Cmd + I on Mac)

Other MCP-compatible Clients

Any application supporting the Model Context Protocol can utilize this server:

• Windsurf by Codeium: Similar setup to Cursor with MCP configuration

Local Development

Running with Inspector

For local development and testing, you can run the MCP server with the official inspector:

# Run with inspector for testing and debugging
npx @modelcontextprotocol/inspector @abelpenton_dev/pulse-mcp-server

The inspector provides a web interface for testing MCP server functionality and exploring available tools.

Available Tools

Pulse React

Modern React component integration for seamless checkout experiences.

Prompts Examples:

• Install and implement pulse react component in my checkout page

  • Generates complete installation instructions and React component setup
  • Includes RefundableProvider configuration and context setup
  • Provides TypeScript-ready implementation examples

• Generate code for Quote call in pulse react

  • Creates code for updating quote data when internal application state changes
  • Handles quote synchronization with Pulse platform
  • Includes proper error handling and state management

• Write sale using pulse react component

  • Implements sale functionality using the useRefundableActions hook
  • Provides complete transaction handling code
  • Includes best practices for error handling and user feedback

Pulse Widget

JavaScript widget integration for universal compatibility across platforms.

Prompts Examples:

• Install and configure pulse widget in my checkout page

  • Generates JavaScript integration code for any web platform
  • Includes CDN links and initialization scripts
  • Provides configuration options and customization examples

• Render content for pulse widget

  • Creates code for dynamic widget rendering
  • Handles various display configurations and styling options
  • Includes responsive design considerations

Pulse API

Direct API integration tools supporting multiple programming languages and frameworks.

Prompts Examples:

• Implement a service in C# to support Protect Pulse API

  • Generate Services and basic models for Quote and Sale operations

• Implement a service in JS for pulse API hospitality

  • Creates Node.js service implementations for Protect Group Pulse API integration

• Implement a service in Go for pulse API hospitality

  • Generates Go service structs and methods for Protect Group Pulse API integration
  • Includes proper error handling and JSON marshaling
  • Provides HTTP client setup and request/response handling

• Implement a service in Python for pulse API hospitality

  • Creates Python service classes for Protect Group Pulse API integration
  • Provides both asynchronous implementations

Code examples generated with the MCP

For comprehensive examples and sample implementations generated using this MCP server, visit:

Pulse Implementation Examples

This repository contains practical examples showcasing different integration approaches and implementation patterns for the Pulse platform.

Support

This MCP server is designed to streamline Pulse platform integration across different technology stacks and implementation approaches.