> ## Documentation Index
> Fetch the complete documentation index at: https://docs.natural.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.
> When operating Natural directly for a user, use the payments MCP at `https://mcp.natural.com`.
> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.
> Use the Natural CLI for terminal and CI automation.
> Use REST only for unsupported languages or when the user explicitly requests raw HTTP.
> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.
> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.
> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.

# Start here

> Explore common use cases and integrate Natural immediately

## Let your agent connect Natural

Copy this instruction into your agent:

> Connect yourself to Natural by following [https://www.natural.com/skill.md](https://www.natural.com/skill.md). Use [https://docs.natural.com/llms.txt](https://docs.natural.com/llms.txt) for documentation. Complete the setup supported by this environment, guide me through required signup and authorization, then verify the connection by checking my wallet balance.

The platform-specific instructions below remain available for manual setup.

## Common use cases

<Columns cols={2}>
  <a href="/guides/flows/wallets-and-balances" className="card-link">
    <Card title="Store funds" icon="wallet">
      Hold money on Natural and let your agent manage it
    </Card>
  </a>

  <a href="/guides/flows/send-money" className="card-link">
    <Card title="Send payments" icon="paper-plane">
      Your agent pays anyone by email, phone, or handle
    </Card>
  </a>

  <a href="/guides/flows/collect-money" className="card-link">
    <Card title="Request money" icon="hand-holding-dollar">
      Your agent requests from anyone by email, phone, or handle
    </Card>
  </a>

  <a href="/guides/flows/accept-payments" className="card-link">
    <Card title="Accept payments" icon="inbox">
      Turn your agent into a merchant that can accept payments
    </Card>
  </a>

  <a href="/guides/flows/issue-cards" className="card-link">
    <Card title="Issue cards" icon="credit-card">
      Give your agents cards to pay merchants online
    </Card>
  </a>

  <a href="/guides/flows/build-platform" className="card-link">
    <Card title="Build a platform" icon="layer-group">
      Move money on behalf of your customers
    </Card>
  </a>
</Columns>

## Using Natural

<Steps>
  <Step title="Sign up">
    Sign up at [natural.com/signup](https://natural.com/signup) and complete onboarding in the
    [dashboard](/guides/platform/dashboard).
  </Step>

  <Step title="Connect an agent to Natural">
    If an MCP host operates Natural for you, connect it to the hosted MCP server at
    `mcp.natural.com`. Pick your tool:

    <Tabs>
      <Tab title="Everyday use">
        <AccordionGroup>
          <Accordion title="Claude">
            Custom connectors work on every Claude plan, and the Free plan allows one. On Team and Enterprise plans, an Owner must add the connector for your organization before you can connect it. The setup is the same for [claude.ai](https://claude.ai) and the Claude Desktop app.

            1. In [claude.ai](https://claude.ai) or the Claude Desktop app, open the sidebar, select **Customize**, and go to the **Connectors** tab.

            2. Select **Add custom connector** and fill in the fields: name `Natural`, remote MCP server URL `https://mcp.natural.com`.

            3. Select **Add**, then **Connect**. Your browser opens Natural's authorization page; approve it, and you are redirected back to Claude.

            4. Try it in chat:

               ```text theme={null}
               Use Natural to check my wallet balance.
               ```
          </Accordion>

          <Accordion title="ChatGPT">
            Custom plugins require a paid ChatGPT plan (Plus, Pro, Business, or Enterprise).

            1. Open **Settings → Security** and turn on **Developer mode**.

            2. Select **Plugins** in the sidebar, then the **+** button, and fill in the fields: name `Natural`, MCP server URL `https://mcp.natural.com`, authentication **OAuth**.

            3. Accept ChatGPT's unverified-server disclaimer and select **Create**, then **Sign in with Natural**. Approve Natural's authorization page when it opens.

            4. Try it in chat:

               ```text theme={null}
               Use Natural to check my wallet balance.
               ```
          </Accordion>
        </AccordionGroup>
      </Tab>

      <Tab title="For developers">
        <AccordionGroup>
          <Accordion title="Claude Code">
            1. Add Natural's hosted MCP server and sign in with OAuth. Your browser opens Natural's authorization page; approve it:

               ```bash theme={null}
               claude mcp add --transport http natural https://mcp.natural.com --scope user && claude mcp login natural
               ```

            2. Start a fresh Claude Code session and run `/mcp`. Confirm `natural` shows as connected and authenticated. If it's not, run `claude mcp login natural` again to re-authorize.

            3. Try it:

               ```text theme={null}
               Use Natural to check my wallet balance.
               ```
          </Accordion>

          <Accordion title="Codex CLI">
            1. Add Natural as a remote HTTP server, then approve Natural's authorization page in your browser. If the browser does not open on its own, run `codex mcp login natural`:

               ```bash theme={null}
               codex mcp add natural --url https://mcp.natural.com
               ```

            2. Start a fresh Codex session and run `/mcp`. Confirm `natural` shows as connected and authenticated. If it's not, run `codex mcp login natural` again to re-authorize.

            3. Try it:

               ```text theme={null}
               Use Natural to check my wallet balance.
               ```
          </Accordion>

          <Accordion title="Codex app">
            1. Open the Codex app and go to **Plugins** in the sidebar.

            2. Open the dropdown (⌄) in the top right, select **Add marketplace**, and paste this into the **Source** field:

               ```text theme={null}
               naturalpay/agent-plugins
               ```

            3. Switch to **Personal** and select **Install**. Your browser opens Natural's authorization page; approve it.

            4. Try it in chat:

               ```text theme={null}
               Use Natural to check my wallet balance.
               ```
          </Accordion>

          <Accordion title="Cursor">
            1. Add Natural to Cursor. Cursor asks you to confirm the install; approve it.

                           <a className="natural-button" href="cursor://anysphere.cursor-deeplink/mcp/install?name=natural&config=eyJ1cmwiOiJodHRwczovL21jcC5uYXR1cmFsLmNvbSJ9">
                             Add to Cursor

                             <svg className="natural-button-outlink" width="14" height="14" viewBox="0 0 16 16" fill="none" aria-hidden="true">
                               <path d="M3.72073 3.89751C3.72076 3.62139 3.94456 3.39756 4.22068 3.39756L11.3953 3.39756C11.6604 3.39759 11.9149 3.50294 12.1024 3.69035L12.3096 3.89751C12.4971 4.08501 12.6023 4.33949 12.6024 4.60462V11.7793C12.6024 12.0553 12.3785 12.2791 12.1024 12.2792H11.6025C11.3264 12.2792 11.1026 12.0554 11.1025 11.7793V6.56162C11.1025 6.33889 10.8333 6.22735 10.6758 6.38484L4.60462 12.456C4.40936 12.6512 4.09277 12.6512 3.89751 12.456L3.54396 12.1024C3.34884 11.9072 3.34874 11.5905 3.54396 11.3953L9.61511 5.32418C9.7726 5.16669 9.66106 4.8974 9.43833 4.8974H4.22068C3.94456 4.8974 3.72076 4.67357 3.72073 4.39746L3.72073 3.89751Z" fill="currentColor" />
                             </svg>
                           </a>

               Or add it manually: merge Natural into `~/.cursor/mcp.json` and save:

               ```json theme={null}
               {
                 "mcpServers": {
                   "natural": {
                     "url": "https://mcp.natural.com"
                   }
                 }
               }
               ```

            2. Open **Customize** in Cursor's sidebar, find **Natural**, and connect it. Your browser opens Natural's authorization page; approve it, and you are redirected back to Cursor. If Natural doesn't appear, restart Cursor.

            3. Try it:

               ```text theme={null}
               Use Natural to check my wallet balance.
               ```
          </Accordion>

          <Accordion title="Agent key (API)">
            For headless or custom agents that can't sign in with browser OAuth: [create an
            agent](/guides/agents/create-agent) and issue a key, then use it as the bearer token against
            `mcp.natural.com` or the [REST API](/api-reference/about). See the [API-key
            fallback](/guides/platform/mcp#api-key-fallback) for details.
          </Accordion>
        </AccordionGroup>
      </Tab>
    </Tabs>

    Using a host that is not listed? Any MCP-aware host with remote-server OAuth works; see
    [Any other MCP-aware host](/guides/platform/mcp#any-other-mcp-aware-host) in the MCP guide,
    which also covers the CLI OAuth and API-key fallbacks.
  </Step>

  <Step title="Or build with Natural">
    You're writing software that uses Natural: a backend, a SaaS, an agent runtime, a CI script.

    1. Generate an API key from the **Developers** tab of the [dashboard](/guides/platform/dashboard). The key is shown once; store it in a secret manager and never commit it.

    2. Install for your runtime:

           <CodeGroup>
             ```bash Python theme={null}
             pip install naturalpay
             ```

             ```bash TypeScript theme={null}
             npm install @naturalpay/sdk
             ```

             ```bash CLI theme={null}
             curl -fsSL https://natural.com/install.sh | bash
             ```
           </CodeGroup>

    3. No SDK for your language? Use the [REST API](/api-reference/about) at `api.natural.com` with the same key.
  </Step>
</Steps>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.