# toadlyBroodle/satring [Health: Active]

**Category:** 🔗 Aggregators  
**Repository:** https://github.com/toadlyBroodle/satring/tree/main/mcp  
**GitHub Stars:** 7  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/toadlybroodle-satring

## Description
Discover and compare L402 + x402 paid API services from satring.com, the best curated Lightning and USDC API directory.

## Tools
Capabilities this server exposes over MCP:

- **discover_services** — Search for services by keyword
- **list_services** — List services with category/status/protocol filters and sorting
- **get_service** — Get full details for a service by slug
- **get_ratings** — Get ratings and reviews for a service
- **list_categories** — List all service categories
- **compare_services** — Side-by-side comparison of two services
- **find_best_service** — Search + rank by strategy (cheapest, top-rated, best)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "satring": {
    "command": "uvx",
    "args": ["satring-mcp"],
    "env": {
      "SATRING_API_URL": ""
    }
  }
}
```

**Requires environment variables:** `SATRING_API_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What toadlyBroodle/satring does

toadlyBroodle/satring exposes satring.com’s curated directory of paid API services through the Model Context Protocol. The directory covers L402, x402, and MPP services, allowing an MCP-compatible agent to search for providers and inspect their published information programmatically.

The server is intended for discovery and comparison rather than for calling the listed APIs themselves. An agent can find candidates by keyword, narrow results using service metadata, retrieve a service record by slug, inspect ratings and reviews, and compare two services side by side.

## How it works

The package runs as a local stdio MCP process. Once an MCP client starts the `satring-mcp` command, tool requests are sent to the satring.com API. The API base URL defaults to `https://satring.com/api/v1` and can be changed with `SATRING_API_URL`.

Service listings can be filtered by category, status, and protocol, then sorted using several strategies. The `cheapest` strategy orders results by `pricing_sats`; `top-rated` prioritizes average rating and rated services; and `most-reviewed` uses review count. The `best` strategy combines rating and price and is the default for `find_best_service`.

## Setup and configuration

Install the Python package with either pipx or pip:

```bash
pipx install satring-mcp
```

```bash
pip install satring-mcp
```

Configure an MCP client to launch `satring-mcp` as a stdio server. The package includes documented configuration entries for Claude Desktop, Cline in VS Code, and Claude Code. For a local development checkout, install the package in editable mode from the `mcp` directory and run `satring-mcp`.

Set `SATRING_API_URL` when requests should use a different compatible API base URL. Without that variable, requests target satring.com’s v1 API endpoint.

## Tools and capabilities

The available tools are:

- `discover_services` searches for services by keyword.
- `list_services` returns services with category, status, and protocol filters plus sorting options.
- `get_service` retrieves complete details for a service identified by slug.
- `get_ratings` returns ratings and reviews for a service.
- `list_categories` returns the available service categories.
- `compare_services` compares two services side by side.
- `find_best_service` searches and ranks services according to a selected strategy.

Together, these operations support workflows such as finding Lightning- or USDC-oriented API providers, checking service reputation, and selecting between alternatives based on cost or ratings.

## Limitations and notes

The satring.com API applies per-IP rate limits. List and search operations are limited to 6 requests per minute, while service-detail requests allow 15 requests per minute. Agents that perform repeated discovery or inspection should account for these limits.

The server provides directory access and comparison tools; its documented interface does not indicate that it executes or pays for the APIs listed in satring.com. The development command `mcp dev satring_mcp.py` can launch an MCP Inspector UI for local testing.

_Full upstream README: https://allmcps.com/mcp/toadlybroodle-satring/readme_