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

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

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.

FastMCP v2 🚀

jlowin

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

26.0K
Advertise