# io.usefulapi/recurly (remote · recurly.usefulapi.io)

MCP server for Recurly — accounts, subscriptions, invoices, plans; cancel & pause subs.

- Trust score: 72/100 (medium)
- Change this week: +4
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `recurly.usefulapi.io`: 72/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-recurly/recurly.md), [page](https://verifymcp.io/servers/io-usefulapi-recurly/recurly)

## Channel facts

- Endpoint: `https://recurly.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 78/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 72/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1119 tokens (~139/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 60/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http io-usefulapi-recurly https://recurly.usefulapi.io/mcp
```

### Codex

```toml
[mcp_servers.io-usefulapi-recurly]
url = "https://recurly.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-recurly": {
      "type": "remote",
      "url": "https://recurly.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-recurly --url https://recurly.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-recurly:
    url: "https://recurly.usefulapi.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-recurly": {
      "type": "http",
      "url": "https://recurly.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 72, +54)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Stability: unverified → 0.20
- [functional improvement] Tool coverage: unverified → 100

### 2026-08-01 (score 18, −53)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.13 → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-07-31 (score 71, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 68, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-28 (score 69, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-27 (score 68, +56)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 12)

First indexed and scored.

## MCP tools (8)

### `recurly_list_accounts` (~197 tokens)

List accounts

List customer accounts on the site. Supports cursor pagination and filtering. Recurly: GET /accounts.

Input parameters:

- `begin_time` (string): ISO 8601 lower bound (inclusive) for the `sort` field, e.g. 2026-01-01T00:00:00Z.
- `email` (string): Filter by account email (filter_account_email).
- `end_time` (string): ISO 8601 upper bound (exclusive) for the `sort` field.
- `limit` (integer): Page size, 1–200. Default 20 (Recurly default).
- `order` (string): Sort direction. Default desc.
- `past_due` (boolean): If true, only past-due accounts.
- `sort` (string): Field to order by. Default created_at.
- `subscriber` (boolean): If true, only accounts with a subscription; if false, only without.

### `recurly_get_account` (~87 tokens)

Get account

Fetch one account by its id (no prefix, e.g. e28zov4fw0v2) or by your own code prefixed with `code-` (e.g. code-bob). Recurly: GET /accounts/{account_id}.

Input parameters:

- `account_id` (string, required): Account id (no prefix) or "code-<your account code>".

### `recurly_list_subscriptions` (~201 tokens)

List subscriptions

List subscriptions across the site, optionally scoped to one account and/or filtered by state. Provide `account_id` to use GET /accounts/{account_id}/subscriptions; otherwise GET /subscriptions.

Input parameters:

- `account_id` (string): Optional: scope to one account. Id (no prefix) or "code-<code>".
- `begin_time` (string): ISO 8601 lower bound (inclusive) for the `sort` field, e.g. 2026-01-01T00:00:00Z.
- `end_time` (string): ISO 8601 upper bound (exclusive) for the `sort` field.
- `limit` (integer): Page size, 1–200. Default 20 (Recurly default).
- `order` (string): Sort direction. Default desc.
- `sort` (string): Field to order by. Default created_at.
- `state` (string): Filter by subscription state.

### `recurly_get_subscription` (~62 tokens)

Get subscription

Fetch one subscription by its id (no prefix) or by uuid prefixed with `uuid-`. Recurly: GET /subscriptions/{subscription_id}.

Input parameters:

- `subscription_id` (string, required): Subscription id (no prefix) or "uuid-<uuid>".

### `recurly_list_invoices` (~211 tokens)

List invoices

List invoices across the site, or for one account when `account_id` is given (GET /accounts/{account_id}/invoices). Recurly: GET /invoices.

Input parameters:

- `account_id` (string): Optional: scope to one account. Id (no prefix) or "code-<code>".
- `begin_time` (string): ISO 8601 lower bound (inclusive) for the `sort` field, e.g. 2026-01-01T00:00:00Z.
- `end_time` (string): ISO 8601 upper bound (exclusive) for the `sort` field.
- `limit` (integer): Page size, 1–200. Default 20 (Recurly default).
- `order` (string): Sort direction. Default desc.
- `sort` (string): Field to order by. Default created_at.
- `state` (string): Filter by invoice state.
- `type` (string): Filter by invoice type.

### `recurly_list_plans` (~155 tokens)

List plans

List the site's subscription plans, optionally filtered by state. Recurly: GET /plans.

Input parameters:

- `begin_time` (string): ISO 8601 lower bound (inclusive) for the `sort` field, e.g. 2026-01-01T00:00:00Z.
- `end_time` (string): ISO 8601 upper bound (exclusive) for the `sort` field.
- `limit` (integer): Page size, 1–200. Default 20 (Recurly default).
- `order` (string): Sort direction. Default desc.
- `sort` (string): Field to order by. Default created_at.
- `state` (string): Filter by plan state.

### `recurly_cancel_subscription` (~104 tokens)

Cancel subscription (WRITE — changes billing)

Cancel a subscription. By default it stays active until the end of the current term (`term_end`); pass timeframe `bill_date` to cancel effective the next bill date. This changes billing state. Recurly: PUT /subscriptions/{subscription_id}/cancel.

Input parameters:

- `subscription_id` (string, required): Subscription id (no prefix) or "uuid-<uuid>".
- `timeframe` (string): When cancellation takes effect. Default term_end (end of current term).

### `recurly_pause_subscription` (~102 tokens)

Pause subscription (WRITE — changes billing)

Pause a subscription for a number of upcoming billing cycles. Set `remaining_pause_cycles` to 0 to resume/cancel an existing pause. This changes billing state. Recurly: PUT /subscriptions/{subscription_id}/pause.

Input parameters:

- `remaining_pause_cycles` (integer, required): Number of billing cycles to pause. 0 resumes/cancels a scheduled pause.
- `subscription_id` (string, required): Subscription id (no prefix) or "uuid-<uuid>".

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-recurly/recurly#diagnostics

## Score history

- 2026-08-03: 72
- 2026-08-02: 72
- 2026-08-01: 18
- 2026-07-31: 71
- 2026-07-30: 68
- 2026-07-29: 69
- 2026-07-28: 69
- 2026-07-27: 68
- 2026-07-26: 12

## Links

- Remote endpoint: https://recurly.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-recurly/recurly/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-recurly/recurly/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-recurly/recurly