> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://natural.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://natural.ferndocs.com/_mcp/server.

# Start here

#### AI assistant

You're an AI host (Codex, Cursor, Claude Code, or another MCP-aware coding agent) helping a user with Natural. The user describes payments in English; you connect Natural's hosted MCP server and call Natural tools.

End state: *"Request \$5.00 from Natural's agent (agt\_xyz)."*

### Read the playbook

#### Set up Natural

Read [https://natural.co/skill.md](https://natural.co/skill.md) and set up Natural for me.
Connect this agent to Natural with OAuth.
Then create my agent and request \$5.00 from Natural's agent.

The user should paste a plain-English prompt like this into their agent. The agent reads the playbook, installs the MCP server, starts OAuth, and tells the user when to approve the Natural authorization page in their browser.

### User gets an account

Have the user sign up at [natural.co/signup](https://natural.co/signup) and complete KYB in the [dashboard](/guides/platform/dashboard). The OAuth consent screen uses their logged-in Natural session; the agent does not need an API key for the primary MCP path.

### Connect MCP with OAuth

The agent chooses the host-specific keyless setup:

* **Codex:** `codex mcp add natural --url https://mcp.natural.co`, then `codex mcp login natural`.
* **Cursor / cursor-agent:** configure `~/.cursor/mcp.json` or `.cursor/mcp.json`, then `cursor-agent mcp login natural`. Cursor asks for the same Natural MCP access during OAuth.
* **Claude Code:** `claude mcp add --transport http natural https://mcp.natural.co --scope user`, then the user runs `/mcp` and selects **Authenticate**.

If the current session does not hot-load newly added tools, reload or restart the host and resume the same prompt. If a host can run commands but cannot do MCP OAuth, use the Natural CLI's browser OAuth (`natural login`) before any API key. Use API keys only for CI, SDK or REST integrations, non-interactive scripts, or hosts that support neither MCP OAuth nor the CLI.

#### Application developer

You're writing software that uses Natural: a backend, a SaaS, an agent runtime, a CI script.

### Sign up and get a key

Sign up at [natural.co/signup](https://natural.co/signup), complete KYB, and generate an API key from the dashboard.

### Install for your runtime

**`Python`**

```bash title="Python"
pip install natural-sdk
```

**`TypeScript`**

```bash title="TypeScript"
npm install @natural-co/sdk
```

**`CLI`**

```bash title="CLI"
cargo install --git https://github.com/fern-demo/natural-cli
```

No SDK for your language? Use the REST API at `api.natural.co`.

### Make your first payment

Walk through the [Create a payment](/guides/create-payment) guide end to end.

## Your first payment

* [Create a payment](/guides/create-payment): send money end to end.
* [Request a payment](/guides/request-payment): collect with a payment link.