Pulsemcp Server

🚀 Pulse MCP Server

A Model Context Protocol (MCP) server that provides tools to discover and explore MCP servers and their integrations via the Pulse MCP API.

✨ Features

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

📦 Installation

Installation in MCP Client

Add it to the MCP client configuration according to your client preferences. For example:

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

1. Clone the repository:

git clone <repository-url>
cd pulsemcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

💻 Usage Examples

Basic Usage

Run the Server

After building, you can run the server directly:

./build/index.js

Or via npm:

npm start

Development

Monitor changes during development:

npm run watch

To check the MCP implementation of the server:

npm run inspector

Advanced Usage

Available Tools

list_servers

List MCP servers with optional filtering and pagination.

Parameters:

• query (optional): Search term for filtering servers.
• integrations (optional): Array for filtering by integration tags.
• count_per_page (optional): Number of results per page (maximum: 5000).
• offset (optional): Number of results to skip.

Example:

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

list_integrations

List all available integrations. This tool does not accept any parameters.

Response Format

Both tools return responses in JSON format with the following structures:

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 Tag",
          "url": "https://integration-url.com"
        }
      ]
    }
  ],
  "total_count": 1,
  "next": null
}

list_integrations Response

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

🔧 Technical Details

Error Handling

The server includes robust error handling for:

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

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

Project Structure

pulsemcp-server/
{
  "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 Tag",
      "url": "https://integration-url.com"
    }
  ]
}

Dependencies

• express: "^4.18.2"
• cors: "^2.8.5"
• dotenv: "^16.0.3"

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.

🤝 Contribution Guidelines

Contributions to this project are welcome! Please refer to our CONTRIBUTING.md file to learn how to get involved.