Durable MCP Tripleshot Server

Durable MCP Tripleshot Server exposes the Tripleshot public API through Durable MCP, enabling you to access prompts data and rendering capabilities via robust MCP tooling. It provides both HTTP-based MCP access and a local stdio flow for development and testing, with a durable context that safely retries operations.

How to use

You interact with this server using an MCP client or the included interactive client. The server exposes endpoints to list communities, search prompts, fetch prompts by ID, view trending and featured prompts, and render prompts through a templating step. You can run the server locally and point your MCP client at the local MCP URL to start making requests.

How to install

Prerequisites you need before starting:

uv init --python 3.12.11
uv add reboot durable-mcp httpx "mcp[cli]"

How to install

Create a runtime configuration to run the development server locally.

dev run --no-generate-watch
dev run --python --application=server.py --working-directory=.
dev run --watch=**/*.py

How to install

Start the development server. The MCP endpoint will be available at the local URL shown after startup.

rbt dev run
# MCP available at http://127.0.0.1:9991/mcp

How to install

Configure the server for Claude Desktop usage. Create the following Claude desktop configuration to point Claude at the local MCP endpoint.

{
  "mcpServers": {
    "durable-mcp-tripleshot-1": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:9991/mcp/"
      ]
    }
  }
}

Notes

Before using Claude Desktop, ensure the server is running (rbt dev run). The server can be accessed via the local MCP URL and the HTTP endpoint is hosted at the specified address.

Configuration and runtime details

Environment variables that affect the Tripleshot MCP server and their defaults:

| Variable        | Default                                                |
| --------------- | ------------------------------------------------------ |
| TRIPLESHOT_BASE | https://api.tripleshot.ai                              |
| HTTP_TIMEOUT_MS | 15000                                                  |
| MCP_TOKEN       | unset                                                  |

Observed endpoints and inspection

The server exposes an inspection surface you can access to review runtime state at the internal inspection endpoint.

http://127.0.0.1:9991/__/inspect

Available tools

list_communities

Fetches the list of available communities from the Tripleshot API.

search_prompts

Search prompts with query parameters against the Tripleshot prompts catalog.

get_prompt

Retrieve a specific prompt by its ID from the Tripleshot API.

trending_prompts

Return prompts currently trending on Tripleshot.

featured_prompts

Return a curated set of featured prompts.

render_prompt

Render a prompt body by performing template substitution and returning the final content.