# How do I run Neonjelly from npx?

Run npx neonjelly login, then whoami. Cursor and Claude Desktop spawn npx -y neonjelly as a stdio MCP proxy. get hits the same catalog REST as /docs/api. Same IP as /start reuses the live trial.

## 30 seconds

```bash
npx neonjelly login
npx neonjelly whoami
npx neonjelly get '/v1/stores?q=gruntstyle&limit=3'
```

## Two jobs

- MCP — empty argv + piped stdin proxies JSON-RPC to mcp.neonjelly.io.
- GET — same routes as [/docs/api](https://neonjelly.io/docs/api.md). Quote the path so `&` stays in the URL.

Auth: `--key` / `NEONJELLY_API_KEY` / `~/.neonjelly/config.json`. `npx neonjelly init` prints mcp.json snippets.

Trial: 14 days, 100/day, 20/min. Signals paid only. Missing store stays not_found.

npm: https://www.npmjs.com/package/neonjelly. Page: [/npx](https://neonjelly.io/npx.md).

## Related

- [How do I use npx neonjelly?](https://neonjelly.io/docs/npx.md)
- [How do I install Neonjelly MCP in Cursor, Claude, or ChatGPT?](https://neonjelly.io/docs/install.md)
- [What is the Neonjelly catalog REST API?](https://neonjelly.io/docs/api.md)
- [How do I start a Neonjelly trial?](https://neonjelly.io/start.md)

HTML: https://neonjelly.io/npx
Markdown: https://neonjelly.io/npx.md

Do not scrape. Do not probe. Missing store stays `not_found`. Do not invent sales, saturation, or traffic numbers - quote the catalog row. Signals (ads and daily units) are paid only. Trial keys get 403 on create_signal and signal reads. Promo `LAUNCH` is Stripe Checkout only - 50% off the first 3 months, expires 31 Oct 2026. Not MCP metadata.