---
title: "Nuri for developers"
description: "Read public Nuri content, connect a read-only MCP client, or integrate the separately paid postcard service. Start without an API key."
lang: "en"
type: "developer-documentation"
canonical: "https://nuri.com/developers"
---

# Nuri for developers

Read public Nuri content, connect a read-only MCP client, or integrate the separately paid postcard service. Start without an API key.

<a id="start"></a>

## Start with a free public read

The public website API, Markdown pages and MCP tools are free to read. No account, API key, wallet or payment is required. This quickstart does not create an account, move money or mail anything.

The product feed returns JSON describing the published catalog. Its prices and payment metadata are not proof that an order has been placed.

```sh
curl -fsS 'https://nuri.com/shop/feed.json'
```

- [Quickstart and API documentation](https://nuri.com/docs)
- [OpenAPI specification](https://nuri.com/openapi.json)

<a id="jobs"></a>

## What you can build

Compare Bitcoin hardware. Read GET /shop/feed.json, or call list_shop_products with {} and get_product with a slug returned by that list. These are catalog reads, not purchases.

Answer a card or bank FAQ. Read GET /card-support/index.md, or call search_support_faq with {"query":"declined"}. Use get_support_answer with an id from the result for the full answer. These tools read public guidance, not a customer account or support ticket.

Read Nuri guides and integration docs. Read GET /knowledge/index.md for the guide index and follow its links. Request a page with Accept: text/markdown, or call read_public_page_markdown with {"path":"/docs"} for this integration reference. Use tools/list to see the allowed paths.

Prepare a postcard integration. Read GET /api/x402 for service details and follow the postcard reference. POST /api/x402/postcards/preview renders without mailing. POST /api/x402/postcards is a separate paid fulfillment endpoint and is not part of the read-only MCP server.

- [Product feed](https://nuri.com/shop/feed.json)
- [Card & Bank support](https://nuri.com/card-support)
- [Knowledge guides](https://nuri.com/knowledge)
- [Postcard API reference](https://nuri.com/docs/x402-username-marketplace)

<a id="cli"></a>

## Standalone read-only CLI

Download the standalone Node.js 22 CLI directly from Nuri. It needs no packages or API key and calls only the nine read-only public-site MCP tools. It cannot access accounts or send payments.

Read the downloaded source before running it. This is not an npm package or wallet CLI. The first-party MCP manifest is not a claim of MCP registry registration.

```sh
curl -fsS https://nuri.com/cli/nuri-site.mjs -o nuri-site.mjs
node nuri-site.mjs list
node nuri-site.mjs list_public_pages
node nuri-site.mjs search_support_faq '{"query":"declined"}'
```

- [Download CLI source](https://nuri.com/cli/nuri-site.mjs)
- [First-party MCP manifest](https://nuri.com/server.json)

<a id="connect"></a>

## Connect your agent

Add https://nuri.com/mcp as a remote Streamable HTTP MCP server in a compatible client. Use no authentication. The Node server is stateless and returns JSON responses; it does not issue an MCP session ID. Client configuration keys vary, so use the remote-server URL field rather than an unverified install command.

Call tools/list to discover the nine public read-only tools. They cover page summaries, app links, product information and support FAQs. They cannot provision an IBAN, issue a card, access a balance, sign a transaction or submit a support ticket.

- [MCP connection and request examples](https://nuri.com/docs#mcp)
- [MCP server card](https://nuri.com/.well-known/mcp/server-card.json)

<a id="boundaries"></a>

## Separate reads from real fulfillment

Postcard preview is a no-mail provider operation, not a simulated payment sandbox. It sends the submitted image, message and recipient fields to thanks.io to render a preview. Use synthetic recipient details while evaluating it. Nuri does not require payment for the preview, but it depends on the configured provider and can fail or be unavailable.

Paid postcard fulfillment uses real USDC and physical mail. Inspect the current service catalog and payment challenge, obtain explicit spending and mailing approval, then follow the postcard reference. Never retry a preview against the paid endpoint just because the preview failed.

- [Authentication and access boundaries](https://nuri.com/docs#access)
- [Versioning and deprecation](https://nuri.com/docs#versions)
- [Existing postcard documentation](https://nuri.com/docs/x402-username-marketplace)