---
title: Prosperanova developer platform
description: Prosperanova REST API, CLI, OAuth MCP, billing tools, authentication, and safety boundaries.
canonical: https://www.prosperanova.com/developers/
last-updated: 2026-08-31
---

# Prosperanova developer platform

Integrate subscription billing projects through the REST API, the official Prosperanova CLI, or the OAuth-protected Streamable HTTP MCP at https://mcp.prosperanova.com/mcp.

## Resources

- [Developer documentation](https://www.prosperanova.com/developers/)
- [REST API reference](https://www.prosperanova.com/api/)
- [OpenAPI specification](https://www.prosperanova.com/openapi.json)
- [Authentication guide](https://www.prosperanova.com/auth.md)
- [Prosperanova CLI on npm](https://www.npmjs.com/package/prosperanova)
- [Agent instructions](https://www.prosperanova.com/agents.md)
- [MCP server card](https://www.prosperanova.com/.well-known/mcp/server-card.json)
- [RFC 9727 API catalog](https://www.prosperanova.com/.well-known/api-catalog)
- [Pricing](https://www.prosperanova.com/en/pricing/)
- [Agent index](https://www.prosperanova.com/llms.txt)

## Prosperanova CLI

Install the official [Prosperanova package on npm](https://www.npmjs.com/package/prosperanova) with Node.js 18 or newer. The CLI signs in through the Prosperanova browser authorization flow, stores the resulting local session, and can list, inspect, or create billing projects.

```bash
npm install -g prosperanova
prosperanova login
prosperanova projects list
```

Run the published package without a global install:

```bash
npx prosperanova --help
npx prosperanova projects list
```

## MCP tools

- `list_projects` — List tenant-scoped billing projects.
- `get_project` — Read one project resolved from authenticated results.
- `list_products` — List bounded product summaries.
- `list_prices` — List bounded price summaries.
- `list_customers` — List a bounded page of safe customer fields.
- `get_customer` — Read one tenant-scoped customer projection.
- `list_subscriptions` — List bounded, filtered subscription summaries.
- `get_subscription` — Read one subscription with safe billing fields.
- `list_coupons` — List bounded coupon summaries.
- `list_payments` — List projected payments without raw Stripe objects.
- `list_quotes` — List bounded quotes without arbitrary metadata.
- `create_project` — Create one project with explicit approval.

## Scope model

Use `prosperanova:read` for billing discovery. Request `prosperanova:write` only when the user has explicitly approved creating one project. API keys are pinned to one project; OAuth is the supported remote-connector credential for project tools.

## Data and tenancy safety

Every MCP read goes through the tenant-scoped REST API. Tools never accept an organization identifier, never read MongoDB directly, and never return raw upstream records. Payment projections exclude embedded Stripe PaymentIntent objects and payment-method identifiers. Quote projections exclude arbitrary metadata. Project reads resolve only from the authenticated project list because the legacy single-project REST route is not an approved ownership boundary.
