io.github.TheBaronofAI/okaneland-mcp
Verified AI-tool prices and AI product margin math for agents.
Open source Open in the app JSON README (API)
About
Verified AI-tool prices and AI product margin math for agents.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- thebaronofai
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Last push
- 2026-08-09T14:15:16Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:16
- Updated
- 2026-08-29 03:02:16
- Origin id
io.github.TheBaronofAI/okaneland-mcp
README
# @okaneland/mcp
A small [Model Context Protocol](https://modelcontextprotocol.io) server that gives AI agents two things from [Okane Land](https://okaneland.com):
| Tool | What it does |
| --- | --- |
| `get_ai_tool_prices` | Current, human-verified pricing for 100+ AI tools solo builders use, with what's free, what a real month costs, the gotcha, and the last-verified date. Fetched live from the maintained price index. |
| `calculate_ai_margin` | Turns an AI product's MRR into what you actually keep after the token bill, card fees, failed payments, refunds, and tax, plus the break-even price and usage cap. |
It runs on the user's machine over stdio, so there is nothing to host. `get_ai_tool_prices` fetches the public [`/api/v1/prices.json`](https://okaneland.com/api/v1/prices.json) at call time, so the data is always as fresh as the site's monthly re-verification.
## Install
Add it to your MCP client's config (Claude Desktop, Cursor, Windsurf, and others use the same shape):
```json
{
"mcpServers": {
"okaneland": {
"command": "npx",
"args": ["-y", "@okaneland/mcp"]
}
}
}
```
Restart the client. The two tools appear in any agent you run there.
## Example
> **You:** I want a $20/mo AI writing tool on Claude Sonnet. What do similar tools charge, and would $20 keep money at 500 users?
The agent calls `get_ai_tool_prices` and `calculate_ai_margin`, then answers from real data: comparable tools charge more, and at 500 users on a Sonnet-class blend you keep about **$3,260/mo (33%)**, staying profitable down to a **$12.25** price or up to **3.3M** tokens per user.
## Tool reference
### `get_ai_tool_prices`
Inputs (all optional): `category`, `query`, `id`, `limit`. Returns the matching tool rows plus the index's `updated` date, `method`, and source `page`.
### `calculate_ai_margin`
Inputs: `pricePerMonth`, `payingCustomers`, `blendedTokenPricePerM`, `tokensPerUserM`, and optional `monthlyChurnPct` (6.1), `intlCardPct` (40), `vatPct` (0), `failedPaymentsPct` (9), `refundsPct` (3). Returns `gross`, `tokenBill`, `cardFees`, `failedPayments`, `refunds`, `tax`, `keep`, `keepPct`, `perCustomerKeep`, `customersReplacedMonthly`, `breakEvenPrice`, `breakEvenTokensPerUserM`, and `tokenCostExceedsPrice`.
## Privacy
The server fetches only the public price index over HTTPS and sends nothing about you. The margin calculation runs entirely locally.
## Develop
```bash
npm install
npm run build # tsc -> dist/
npm test # unit tests pin the margin math to the web calculator
npm run smoke # spins up the server, runs the MCP handshake, calls both tools
```
The margin math in `src/margin.ts` is a port of Okane Land's [margin calculator](https://okaneland.com/palette/keep/); `src/margin.test.ts` pins its known-good outputs so the two cannot silently drift.
## Disclaimer
Numbers are directional, not financial advice.
## License
MIT