📌Overview

Purpose: The PulseMCP Server aims to facilitate the discovery and exploration of Model Context Protocol (MCP) servers and integrations through its API.

Overview: PulseMCP Server offers a comprehensive set of tools that allow users to efficiently list, search, and filter MCP servers and their respective integrations, making it easier for developers to interface with various MCP implementations.

Key Features:

• Server Listing: Lists available MCP servers with filtering and pagination options, enabling users to find servers that meet specific criteria.

• Integration Management: Provides a feature to list all available integrations, thereby simplifying the process of integration tracking and utilization.

---

PulseMCP Server

A Model Context Protocol (MCP) server providing tools for discovering and exploring MCP servers and integrations through the PulseMCP API.

Features

• List available MCP servers with filtering and pagination
• Search MCP servers by name or functionality
• Filter servers by integration types
• List all available integrations
• Full TypeScript support

Installation

Installing in MCP Clients

Add this to your MCP client configuration, adapting it as needed:

{
  "mcpServers": {
    "pulsemcp": {
      "command": "npx",
      "args": ["-y", "pulsemcp-server"]
    }
  }
}

Setup

1. Clone the repository:

git clone <repository-url>
cd pulsemcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

Usage

Running the Server

Run the server directly after building:

./build/index.js

Or via npm:

npm start

Development

Watch for changes:

npm run watch

Inspect the server's MCP implementation:

npm run inspector

Available Tools

list_servers

Lists MCP servers with optional filtering and pagination.

Parameters:

• query (optional): Search term
• integrations (optional): Array of integration slugs
• count_per_page (optional): Number of results per page (max 5000)
• offset (optional): Number of results to skip

Example:

{
  "query": "toolhouse",
  "integrations": ["github"],
  "count_per_page": 10,
  "offset": 0
}

list_integrations

Lists all available integrations. No parameters required.

Response Format

list_servers Response

{
  "servers": [
    {
      "name": "Server Name",
      "url": "https://example.com",
      "external_url": "https://external-link.com",
      "short_description": "Server description",
      "source_code_url": "https://github.com/example/repo",
      "github_stars": 123,
      "package_registry": "npm",
      "package_name": "package-name",
      "package_download_count": 1000,
      "integrations": [
        {
          "name": "Integration Name",
          "slug": "integration-slug",
          "url": "https://integration-url.com"
        }
      ]
    }
  ],
  "total_count": 1,
  "next": null
}

list_integrations Response

{
  "integrations": [
    {
      "name": "Integration Name",
      "slug": "integration-slug",
      "url": "https://integration-url.com"
    }
  ]
}

Error Handling

Handles:

• Invalid parameters
• API connection issues
• Rate limiting
• Authentication errors

Errors are returned in a standardized format with appropriate error codes and messages.

Development

Project Structure

pulsemcp-server/
├── src/
│   └── index.ts    # Main server implementation
├── build/          # Compiled JavaScript
├── package.json    # Project configuration
└── tsconfig.json   # TypeScript configuration

Dependencies

• @modelcontextprotocol/sdk: ^0.6.0
• axios: ^1.7.9
• TypeScript: ^5.3.3

License

Read LICENSE.MD

Contributing

Open a PR – be nice and you will be rewarded!