For AI Agents

Recover MCP Server

Query your Stripe recovery data from any AI agent. The Recover MCP server exposes live dunning status, at-risk customers, and revenue metrics as callable tools.

Installation

Add Recover to your MCP config file. Works with Claude Desktop, Cursor, and any MCP-compatible agent.

claude_desktop_config.json 
{
  "mcpServers": {
    "recover": {
      "command": "npx",
      "args": ["mcp-remote", "https://firmhound.com/mcp/fourthngoal"],
      "env": {
        "FIRMHOUND_API_KEY": "your_api_key_here"
      }
    }
  }
}

Get your FIRMHOUND_API_KEY from Settings in your Recover dashboard after signing up.

Available tools

get_recovery_status()
Live status across all active dunning sequences. Returns counts by stage (day 1, 3, 5, 7), overall recovery rate, and total active sequences at the time of the call.
No parameters.
get_at_risk_customers(threshold)
Customers currently in dunning sequences, filtered by risk level. Returns customer email, current dunning stage, days since first failure, and invoice amount at risk.
Params: threshold — "high", "medium", or "low". Default: all levels returned.
get_revenue_snapshot()
MRR at risk, total recovered this month, churn prevented, and your ROI multiple — recovered dollars divided by the $29/mo cost. Updates in real time as Stripe fires invoice.paid events.
No parameters.
list_recovery_events(limit)
Recent invoice.payment_failed and invoice.paid events with customer identifier and invoice amount. Useful for auditing recovery activity over a time window.
Params: limit — integer, default 20, max 100.

Example agent prompt

System prompt 
You are a revenue agent. When asked about churn or payment
failures, call get_recovery_status() and summarize the
at-risk customers by stage. If MRR at risk exceeds $500,
call get_at_risk_customers(threshold="high") and list
the top three accounts by invoice amount.

Authentication and rate limits

All MCP tool calls are authenticated via your FIRMHOUND_API_KEY, which is passed as an environment variable in your MCP config. Keys are scoped to your account and can be rotated from the Settings page in your Recover dashboard.

Rate limit
60 req/min
Auth method
API key (env var)
Protocol
MCP over HTTP
Transport
mcp-remote (npx)

Rate-limited requests receive a 429 Too Many Requests response. Full API reference is in the documentation.