home / mcp / noaas mcp server

NoaaS MCP Server

Provides an MCP wrapper around a REST API delivering 1,000+ rejection responses across categories through stdio and HTTP endpoints.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "koneisto-no-as-a-service": {
      "url": "https://api.mcp-for-no.com/v1/tools/call",
      "headers": {
        "API_BASE_URL": "https://api.mcp-for-no.com"
      }
    }
  }
}

NoaaS provides a local MCP server wrapper around a REST API that delivers 1,000+ rejection responses. The MCP server lets you connect with Claude Desktop or Cursor via a simple stdio interface, while the actual data and logic live in the REST API. This setup gives you a fast, local bridge to a broad set of canned responses that you can request from an MCP client.

How to use

You connect with an MCP client (such as Claude Desktop or Cursor) to the local MCP server through stdio. Start the local server, then configure your MCP client to launch the server as a process that communicates via stdin and stdout. Once configured, you can request a random rejection by category (for example, humorous or polite) and receive a structured response from the REST API under the MCP wrapper.

How to install

Prerequisites you need before starting are Node.js version 18 or newer and Git. Follow these steps to install and run the MCP server locally.

Clone the project, install dependencies, and build the MCP server.

Additional sections

Security considerations: limit exposure by enabling rate limiting and CORS controls as needed, and ensure the local MCP wrapper is only accessible to trusted clients. Monitor logs in your system's log directory and rotate them to avoid disk growth. The REST API behind the wrapper hosts the business logic and data, so protect that surface accordingly.

Troubleshooting tips: verify the MCP wrapper path is correct, ensure Node.js is installed, and restart the MCP client after changing the configuration. If the client cannot connect, double‑check the CLI or UI configuration to point to the local stdio wrapper and not the public REST API endpoint.

Available tools

getRandomNo

Fetches a creative rejection message, with optional category filtering (polite, humorous, professional, creative).

getNoCount

Returns the total number of available rejection messages.