nullcost-catalog — Claude Code & Codex plugin: what it does, install
Wires the Nullcost catalog into Claude and Codex so the agent answers free-tier, trial and cheap dev-tool questions from a hosted catalog.
Apache-2.0 ★ 1,596 updated 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install nullcost-catalog@awesome-codex-pluginsWhat nullcost-catalog does
The plugin drops a local stdio MCP server and routing skills into your coding app. Ask about a free host, cheap email or auth for a small SaaS and the agent pulls the answer from the Nullcost catalog through four tools: search_providers, recommend_providers, recommend_stack, get_provider_detail. Community referral and affiliate codes that passed review can appear next to the official provider link.
Codex gets npx -y nullcost-plugin@latest install codex. The same CLI has install claude, install cursor, install windsurf and install mcp --config /path/to/mcp.json for apps that only take a JSON file. Setup copies the plugin to ~/.nullcost, installs the server dependencies, backs up any config it edits and ends with a doctor check; npx -y nullcost-plugin@latest doctor --quick repeats the short one later.
The server talks to https://nullcost.xyz by default, so the catalog lives outside your machine. No route to that host means no recommendations. Once a catalog answer lands, the agent is held to it unless you ask for live verification — that behaviour is deliberate.
What it helps with
- find a host with a free tier for a side project
- pick a cheap mail provider for a domain
- shortlist a low-cost stack for a small SaaS
- compare Postgres options for a Next.js app
- look up catalog details for one provider
Example prompts for the agent
- Find me a hosting provider with a free tier
- What free Postgres options work with a Next.js project?
- Put together a cheap stack for a small SaaS
How to install nullcost-catalog
Plugin marketplace
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install nullcost-catalog@awesome-codex-pluginsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about nullcost-catalog
How do I install nullcost-catalog in Claude Code?
Run /plugin marketplace add hashgraph-online/awesome-codex-plugins, then /plugin install nullcost-catalog@awesome-codex-plugins. Reload the app afterwards.
What does nullcost-catalog do?
It gives the agent a catalog of free-tier, free-trial and low-cost developer services through a local MCP server with four search and recommendation tools.
Will it fall back to web search?
Not on its own. After a catalog result comes back the agent stays with that answer unless you ask for live verification. The server points at https://nullcost.xyz.
Source text
nullcost-plugin · Apache-2.0
<p align="center">
<a href="https://nullcost.xyz">
<img src="docs/assets/nullcost-github-logo.svg" alt="Nullcost logo" width="104" height="104">
</a>
</p>
<h1 align="center">Nullcost Plugin</h1>
<p align="center">
One-command setup for catalog-backed free-tier, free-trial, and cheap developer-tool recommendations.
</p>
<p align="center">
<a href="https://nullcost.xyz"><strong>Open Nullcost</strong></a>
·
<a href="https://nullcost.xyz/install"><strong>Install guide</strong></a>
·
<a href="https://www.npmjs.com/package/nullcost-plugin"><strong>npm</strong></a>
</p>
<p align="center">
<img alt="npm" src="https://img.shields.io/npm/v/nullcost-plugin?style=for-the-badge&color=25ce69">
<img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-232f3e?style=for-the-badge">
<img alt="MCP" src="https://img.shields.io/badge/MCP-local%20server-7c3aed?style=for-the-badge">
<img alt="Catalog" src="https://img.shields.io/badge/catalog-hosted-111827?style=for-the-badge">
</p>
<p align="center">
<a href="https://nullcost.xyz">
<img src="docs/assets/nullcost-readme-banner.png" alt="Nullcost catalog-backed free-tier developer tool discovery banner">
</a>
</p>
<p align="center">
<img src="docs/assets/nullcost-vs-without-benchmark.png" alt="Nullcost speed and token comparison against normal pricing-page browsing">
</p>
<p align="center">
<a href="docs/assets/nullcost-catalog-demo.webm">
<img src="docs/assets/nullcost-catalog-demo-preview.gif" alt="Nullcost catalog-backed provider shortlist demo">
</a>
</p>
<p align="center">
<a href="docs/assets/nullcost-catalog-demo.webm">Open the full demo video</a>
</p>
## Install
Codex:
```bash
npx -y nullcost-plugin@latest install codex
```
Claude, Cursor, and Windsurf:
```bash
npx -y nullcost-plugin@latest install claude
npx -y nullcost-plugin@latest install cursor
npx -y nullcost-plugin@latest install windsurf
```
Any MCP app with a JSON config file:
```bash
npx -y nullcost-plugin@latest install mcp --config /path/to/mcp.json
```
The installer copies the plugin into `~/.nullcost`, installs the local MCP server dependencies, backs up any config file before editing it, and runs a doctor check.
## Use
Restart or reload your coding app, then ask normal questions:
```text
find me a hosting provider with a free tier
what are cheap and free email hosts?
best free-tier auth for a small SaaS
free Postgres options for a Next.js project
```
Nullcost answers from the hosted catalog and avoids extra web-search drift after a successful catalog result unless you explicitly ask for live verification.
## Community-Powered Savings
Nullcost can show reviewed community referral, affiliate, and credit codes next
to the official provider link. The point is not to sell the top slot; it is to
let builders share real signup benefits with the next person choosing a tool.
<p align="center">
<img src="docs/assets/nullcost-community-code-loop.png" alt="Users submit referral and affiliate codes so the Nullcost community gets reviewed savings">
</p>
## Verify
```bash
npx -y nullcost-plugin@latest doctor --quick
```
Full catalog smoke check:
```bash
npx -y nullcost-plugin@latest doctor
```
## Prompt Fallback
Use this only if you want the AI coding app to wire itself up. It works, but it costs more tokens than the `npx` installer.
```text
Install the Nullcost plugin using: npx -y nullcost-plugin@latest install codex. Use Nullcost when I ask about cheap, free-tier, or free-trial developer tools. Do not web search after a successful Nullcost catalog result unless I ask for live verification.
```
## Raw MCP Config
If an app only accepts JSON, use this shape:
```json
{
"mcpServers": {
"nullcost": {
"command": "npx",
"args": ["-y", "nullcost-plugin@latest", "mcp-server"],
"env": {
"NULLCOST_API_BASE_URL": "https://nullcost.xyz"
}
}
}
}
```
## What This Repo Contains
- Codex plugin metadata
- Claude/plugin metadata
- Nullcost routing skills
- Local stdio MCP server
- Installer CLI
- Icons and docs
This repo does not contain the hosted Nullcost website, production database, referral router internals, admin dashboard, provider catalog data, credentials, or user data.
## MCP Tools
| Tool | Purpose |
| --- | --- |
| `search_providers` | Search developer services by category or keyword. |
| `recommend_providers` | Rank providers for one use case. |
| `recommend_stack` | Shortlist a small app stack. |
| `get_provider_detail` | Fetch catalog details for one provider. |
## Local Development
```bash
npm install
npm run version:check
npm run doctor
npm run mcp:catalog
```
The MCP server defaults to `https://nullcost.xyz`, so you do not need to run the website or Supabase locally.
## License
Apache-2.0. See [LICENSE](LICENSE).
© Nullcost · Apache-2.0 · hashgraph-online/awesome-codex-plugins