Advertise
MCP.so
Sign In

MCP REST

@ivanboring

Repository

Basic information

Category

Other

Transports

stdio

Author

ivanboring

About MCP REST

Exposes a SSE MCP server as a rest endpoints for tools. Only for testing

#mcp-rest#api#sse

MCP REST config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-rest": {
      "command": "npx",
      "args": [
        "mcp-rest"
      ]
    }
  }
}

MCP REST tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is MCP REST?

MCP REST is a REST API wrapper around the Model Context Protocol (MCP) client. It allows you to interact with an MCP server over HTTP without maintaining a constant client connection. It is intended for testing purposes only, not for production use.

How to use MCP REST?

Install globally via npm install -g mcp-rest or run with npx mcp-rest. Start the server with options such as --type (SSE only), --url (SSE server URL), --port (Express port), and --debug. Once running, use the provided API endpoints: GET /status to check connection, GET /tools to list tools, and POST /tools/:toolId to call a specific tool with JSON arguments.

Key features of MCP REST

  • Wraps MCP client as a RESTful API.
  • Supports SSE (server-sent events) connection type.
  • Configurable Express server port and SSE URL.
  • Debug logging with --debug flag.
  • Simple HTTP endpoints for status, tools, and tool calls.

Use cases of MCP REST

  • Quickly test MCP tools without setting up a persistent client.
  • Integrate MCP functionality into HTTP-based workflows or scripts.
  • Explore available tools and their parameters via GET /tools.
  • Validate tool calls with custom arguments using POST /tools/:toolId.

Frequently asked questions

1

What is MCP REST meant for?

It is designed for testing and experimentation with MCP, not for production use. The README explicitly states it is "just for testing, not to use for real."

2

How do I install and run MCP REST?

Install globally via `npm install -g mcp-rest` or use `npx mcp-rest` directly. Run with optional arguments like `--port 4000` or `--debug`. The default SSE URL is `http://localhost:8000/sse`.

3

What connection types does MCP REST support?

Currently only SSE (server-sent events) is supported, as indicated by the `--type` option defaulting to `"sse"`.

4

How can I call a tool through the REST API?

Send a POST request to `/tools/:toolId` with a JSON body containing an `"arguments"` object. Example: `curl -X POST http://localhost:3000/tools/exampleTool -H "Content-Type: application/json" -d '{"arguments": {"param1": "value1"}}'`.

5

What should I do if I encounter connection issues?

Use the `--debug` flag to see detailed logs, check the `/status` endpoint to verify connection status, and ensure your MCP server/process is running and accessible.

Comments

More Other MCP servers

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

ICSS

chokcoco

不止于 CSS

20.7K
Advertise