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

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

FastMCP v2 🚀

jlowin

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

26.0K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise