{
  "type": "tool_call",
  "seq": 3,
  "ts": "2026-11-03T17:15:28.443Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "ls -la /sandbox/repo; echo ---; find /sandbox/repo -maxdepth 2 -name \"*.md\" | head -50"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a7e4d58b44a3a657",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 4,
  "ts": "2026-11-03T17:15:28.443Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "total 16\ndrwxr-xr-x 3 root root 4096 Sep 18 08:00 .\ndrwxr-xr-x 7 root root 4096 Nov  3 17:15 ..\ndrwxr-xr-x 8 root root 4096 Sep 24 20:05 .git\n-rw-r--r-- 1 root root  408 Sep 18 08:00 .gitignore\n---\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a7e4d58b44a3a657",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 7,
  "ts": "2026-11-03T17:15:29.306Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /sandbox/repo; cat .gitignore; echo ---; git log --oneline | head -20; echo ---; git remote -v; git status --short"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a7e791cd0004d46f",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 8,
  "ts": "2026-11-03T17:15:29.306Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "# Keep generated and vendored files out of source diffs.\n\n# Logs / OS cruft\n*.log\n.DS_Store\n\n# JavaScript / TypeScript\nnode_modules/\n.next/\ndist/\nbuild/\ncoverage/\n\n# Python\n.venv/\nvenv/\n__pycache__/\n*.py[cod]\n.pytest_cache/\n*.egg-info/\n\n# Rust\ntarget/\n\n# Go / PHP / Ruby vendored deps\nvendor/\n.bundle/\n\n# Java / Kotlin / Scala\n.gradle/\n\n# .NET\nbin/\nobj/\n\n# Elixir\n_build/\ndeps/\n\n# Dart / Flutter\n.dart_tool/\n---\n9ebf5fb Initial workspace\n---\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a7e791cd0004d46f",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 11,
  "ts": "2026-11-03T17:15:31.451Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /sandbox/repo; env | grep -iE \"PI_|api|key|token\" | sed 's/=.*KEY.*/=***/' | head -30; echo ---; timeout 12 curl -sS -o /dev/null -w \"%{http_code}\\n\" https://registry.npmjs.org/ 2>&1; echo ---; timeout 12 curl -sS -o /dev/null -w \"%{http_code}\\n\" https://pypi.org/simple/ 2>&1"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-8681fb55a22a6dce",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 12,
  "ts": "2026-11-03T17:15:35.709Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "PI_CODING_AGENT=true\nPI_REASONING_LEVEL=medium\nPI_SESSION_FILE=/sandbox/.gauge/pi/sessions/2026-11-03T17-15-25-924Z_01a1a268-9764-7c63-8e82-d4b291ad0b30.jsonl\nPI_PROVIDER=gauge-fireworks\nPI_MODEL=accounts/fireworks/models/qwen3p8-max\nPI_SESSION_ID=01a1a268-9764-7c63-8e82-d4b291ad0b30\nPI_GATEWAY_API_KEY=unused\nGIT_CONFIG_KEY_0=safe.directory\n---\n200\n---\n200\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-8681fb55a22a6dce",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 15,
  "ts": "2026-11-03T17:15:37.835Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "ls -la /sandbox; ls /sandbox/.gauge 2>/dev/null; timeout 15 curl -sS \"https://registry.npmjs.org/natural\" | head -c 600; echo; echo ---; timeout 15 curl -sS \"https://pypi.org/pypi/natural/json\" | head -c 600"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-889b130a76d9eeeb",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 16,
  "ts": "2026-11-03T17:15:38.816Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "total 28\ndrwxr-xr-x  7 root root 4096 Nov  3 17:15 .\ndrwxr-xr-x 22 root root 4096 Sep 18 07:59 ..\ndrwxr-xr-x  3 root root 4096 Nov  3 17:15 .cache\ndrwxr-xr-x  3 root root 4096 Nov  3 17:15 .gauge\ndrwxr-xr-x  3 root root 4096 Nov  3 17:15 .pi\ndrwxrwxrwt  2 root root 4096 Sep 18 08:00 .tmp\ndrwxr-xr-x  3 root root 4096 Sep 18 08:00 repo\npi\n{\"_id\":\"natural\",\"_rev\":\"547-be603caa2ce122a0f0aee146c35b9373\",\"name\":\"natural\",\"dist-tags\":{\"latest\":\"8.2.6\"},\"versions\":{\"0.0.27\":{\"name\":\"natural\",\"version\":\"0.0.27\",\"keywords\":[\"natural\",\"language\",\"porter\",\"lancaster\",\"stemmer\",\"bayes\",\"classifier\",\"phonetic\",\"metaphone\",\"inflector\"],\"author\":{\"name\":\"Chris Umbel\",\"email\":\"chris@chrisumbel.com\"},\"_id\":\"natural@0.0.27\",\"maintainers\":[{\"name\":\"chrisumbel\",\"email\":\"chris@chrisumbel.com\"}],\"dist\":{\"shasum\":\"da1e0881abb74edeb29b8d7b751177ba2c954a33\",\"tarball\":\"https://registry.npmjs.org/natural/-/natural-0.0.27.tgz\",\"integrity\":\"sha512-y03ZIT6curl: (23) Failure writing output to destination\n\n---\n{\"info\":{\"author\":\"Wijnand Modderman-Lenstra\",\"author_email\":\"maze@pyth0n.org\",\"bugtrack_url\":null,\"classifiers\":[],\"description\":\"Example Usage\\n=============\\n\\nBasic usage::\\n\\n    >>> from natural.file import accessed\\n    >>> print accessed(__file__)\\n    just now\\n\\nWe speak your language (with `your support`_)::\\n\\n    >>> import locale\\n    >>> locale.setlocale(locale.LC_MESSAGES, 'nl_NL')\\n    >>> print accessed(__file__)\\n    zojuist\\n\\nBugs/Features\\n=============\\n\\nYou can issue a ticket in GitHub: https://github.com/tehmaze/natural/issues\\n\\nDocumentation\\n=============\\n\\nThe pr",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-889b130a76d9eeeb",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 19,
  "ts": "2026-11-03T17:15:40.239Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "for d in natural.ai natural.dev natural.io natural.com trynatural.com usenatural.com natural.so withnatural.com naturalhq.com getnatural.com; do code=$(timeout 10 curl -sS -o /dev/null -w \"%{http_code}\" -L \"https://$d\" 2>/dev/null); echo \"$d -> $code\"; done"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a78ae4580bd9b7d7",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 20,
  "ts": "2026-11-03T17:16:06.007Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "natural.ai -> \nnatural.dev -> 200\nnatural.io -> 403\nnatural.com -> 200\ntrynatural.com -> 200\nusenatural.com -> \nnatural.so -> 502\nwithnatural.com -> 502\nnaturalhq.com -> 502\ngetnatural.com -> 502\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a78ae4580bd9b7d7",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 23,
  "ts": "2026-11-03T17:16:07.345Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "for d in natural.dev natural.com trynatural.com; do echo \"=== $d\"; timeout 12 curl -sSL \"https://$d\" 2>/dev/null | tr -d '\\n' | sed 's/<[^>]*>/ /g' | tr -s ' ' | head -c 900; echo; done"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-92c6877fa019e224",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 24,
  "ts": "2026-11-03T17:16:09.865Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "=== natural.dev\n Natural — Powering agentic payments (function(w,d,s,l,i){if(w.location.pathname.startsWith(\"/customer-view/\"))return;try{if(w.sessionStorage.getItem(\"natural-customer-view-session-id\"))return;}catch{return;}w[l]=w[l]||[];w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','GTM-MC5QH7WB'); {\"@context\":\"https://schema.org\",\"@type\":\"Organization\",\"name\":\"Natural\",\"url\":\"https://www.natural.com\",\"logo\":\"https://www.natural.com/assets/brand/natural-logo.svg\",\"description\":\"Natural is the agentic payments platform powering frictionless money movement between agents, businesses, and consumers.\",\"foundingDate\":\"2025-08-12\",\"sameAs\":[\"https://x.com/naturalpay\",\"h\n=== natural.com\n Natural — Powering agentic payments (function(w,d,s,l,i){if(w.location.pathname.startsWith(\"/customer-view/\"))return;try{if(w.sessionStorage.getItem(\"natural-customer-view-session-id\"))return;}catch{return;}w[l]=w[l]||[];w[l].push({'gtm.start':new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src='https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);})(window,document,'script','dataLayer','GTM-MC5QH7WB'); {\"@context\":\"https://schema.org\",\"@type\":\"Organization\",\"name\":\"Natural\",\"url\":\"https://www.natural.com\",\"logo\":\"https://www.natural.com/assets/brand/natural-logo.svg\",\"description\":\"Natural is the agentic payments platform powering frictionless money movement between agents, businesses, and consumers.\",\"foundingDate\":\"2025-08-12\",\"sameAs\":[\"https://x.com/naturalpay\",\"h\n=== trynatural.com\n window.onload=function(){window.location.href=\"/lander\"} \n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-92c6877fa019e224",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 27,
  "ts": "2026-11-03T17:16:11.107Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "timeout 15 curl -sSL https://natural.dev 2>/dev/null | grep -oE 'href=\"[^\"]+\"' | sort -u | head -60; echo \"=== pricing\"; timeout 15 curl -sSL -o /dev/null -w \"%{http_code}\\n\" https://natural.dev/pricing"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b9a9bebf4ef48020",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 28,
  "ts": "2026-11-03T17:16:13.175Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "grep: (standard input): binary file matches\nhref=\"/assets/_marketing-BV5-7WzO.js\"\nhref=\"/assets/_marketing-CRS6NBvT.css\"\nhref=\"/assets/brand/natural-logo.svg\"\nhref=\"/assets/chunk-SNIEDJZS-lzWMCoZ7.js\"\nhref=\"/assets/container-BXOvIyjJ.js\"\nhref=\"/assets/container-CK6AJ6fD.css\"\nhref=\"/assets/dappled-scene-CXQA2Zyl.js\"\nhref=\"/assets/icons/agents/agent.svg\"\nhref=\"/assets/icons/agents/bank-account.svg\"\nhref=\"/assets/icons/agents/card.svg\"\nhref=\"/assets/icons/agents/deposit.svg\"\nhref=\"/assets/icons/agents/people.svg\"\nhref=\"/assets/icons/agents/shield.svg\"\nhref=\"/assets/icons/agents/verified.svg\"\nhref=\"/assets/icons/agents/wallet.svg\"\nhref=\"/assets/icons/agents/withdraw.svg\"\nhref=\"/assets/images/agents/penny-avatar.jpg\"\nhref=\"/assets/images/benefits/fdic-card.jpg\"\nhref=\"/assets/images/blog/direct/direct-hero-be751b88.jpg\"\nhref=\"/assets/images/blog/why-david-joined-natural/david-blog-hero.jpg\"\nhref=\"/assets/images/blog/why-jerry-joined-natural/jerry-blog-hero.jpg\"\nhref=\"/assets/images/blog/why-sarah-joined-natural/sarah-blog-hero.jpg\"\nhref=\"/assets/images/brand/nature-desk.jpg\"\nhref=\"/assets/images/home/control-owner-avatar.png\"\nhref=\"/assets/images/home/developers-background.png\"\nhref=\"/assets/images/products/flows-background.jpg\"\nhref=\"/assets/images/products/flows-hold.jpg\"\nhref=\"/assets/index-CVggN9F6.css\"\nhref=\"/assets/index-Ce7JSQue.css\"\nhref=\"/assets/index-l4a0rYoP.js\"\nhref=\"/assets/index-nQ_4JgNS.js\"\nhref=\"/assets/index-weneIaNO.js\"\nhref=\"/assets/investors-B84tOwFR.css\"\nhref=\"/assets/investors-Cr-mcueD.js\"\nhref=\"/assets/marketing-card-CjBFsiAw.css\"\nhref=\"/assets/marketing-card-Dkgovkcq.js\"\nhref=\"/assets/section-header-ClSns3uX.css\"\nhref=\"/assets/section-header-DeMNsmxE.js\"\nhref=\"/assets/splash-BLYxRGXw.js\"\nhref=\"/assets/splash-Dv7EPY0k.css\"\nhref=\"/assets/status-chip-Bum14SjW.js\"\nhref=\"/assets/status-chip-CdvKb7jI.css\"\nhref=\"/assets/styles-BbAPEJvN.css\"\nhref=\"/assets/tabs-CfKLwSZY.css\"\nhref=\"/assets/tabs-CoNTKdSG.js\"\nhref=\"/favicon-512.png\"\nhref=\"/favicon.ico\"\nhref=\"/favicon.png\"\nhref=\"/fonts/gt-standard/GT-Standard-Mono-Standard-Regular.woff2\"\nhref=\"/fonts/stk-miso/STKMisoVariableComplete.woff2\"\nhref=\"https://www.natural.com/\"\n=== pricing\n200\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b9a9bebf4ef48020",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 31,
  "ts": "2026-11-03T17:16:14.954Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; for u in docs.natural.dev docs.natural.com natural.dev/docs api.natural.dev; do echo \"$u -> $(timeout 10 curl -sSL -o /dev/null -w '%{http_code}' https://$u 2>/dev/null)\"; done; echo ===; timeout 20 curl -sSL https://natural.dev/assets/_marketing-BV5-7WzO.js -o mkt.js; ls -la mkt.js; grep -oE '(docs|pricing|sdk|api)[^\"'\"'\"']{0,60}' mkt.js | sort -u | head -40"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-bd57fee548fe12b0",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 32,
  "ts": "2026-11-03T17:16:20.723Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "docs.natural.dev -> 404\ndocs.natural.com -> 200\nnatural.dev/docs -> 200\napi.natural.dev -> 404\n===\n-rw------- 1 root root 19036 Nov  3 17:16 mkt.js\ndocs.natural.com\ndocs.natural.com/api-reference\ndocs.natural.com/guides\npricing\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-bd57fee548fe12b0",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 35,
  "ts": "2026-11-03T17:16:22.298Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; for u in https://docs.natural.com/llms.txt https://docs.natural.com/openapi.json https://docs.natural.com/api-reference https://docs.natural.com/pricing https://docs.natural.com/quickstart; do echo \"$u -> $(timeout 12 curl -sSL -o /dev/null -w '%{http_code}' $u 2>/dev/null)\"; done; echo ===; timeout 20 curl -sSL https://docs.natural.com/llms.txt | head -80"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a0db1ca3f1869baa",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 36,
  "ts": "2026-11-03T17:16:28.684Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "https://docs.natural.com/llms.txt -> 200\nhttps://docs.natural.com/openapi.json -> 404\nhttps://docs.natural.com/api-reference -> 200\nhttps://docs.natural.com/pricing -> 404\nhttps://docs.natural.com/quickstart -> 200\n===\n# Natural\n\n> Natural is the agentic payments platform: one API for AI agents, apps, and businesses to send, receive, and manage money.\n\n## Connect Natural to this agent\n\nUse the setup section of https://www.natural.com/skill.md to connect Natural, then return to the user's task. Check whether Natural tools are already callable before installing another connection.\n\nIn a cloud agent, distinguish the active session's connectors from CLI configuration inside its container. A CLI configuration entry does not prove that this session can call Natural tools. Inspect available host capabilities; do not assume every agent is an MCP host or that every cloud session supports browser OAuth or session reload. If a documented network-policy denial blocks Natural, report the blocked host and complete independent non-secret setup; do not repeatedly try alternate routes around the policy. If an existing connector is disabled, identify the supported activation step before adding another connection.\n\nThe user completes required signup, identity verification, and OAuth consent. Verify with a successful read-only Natural tool call before reporting connected. Report configuration, authentication, tool availability, and account readiness separately. Continue with the full guidance below.\n\n<!-- BEGIN GENERATED AGENT INSTRUCTIONS -->\n> ## Agent Instructions\n> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.\n> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.\n> Use the Natural CLI for terminal and CI automation.\n> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.\n> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.\n<!-- END GENERATED AGENT INSTRUCTIONS -->\n\n**You (the agent reading this) are the MCP host the user is talking through.** If a user asks you to use, set up, or operate Natural for them:\n\n**Read the playbook, connect with OAuth, then operate via natural language.** If the user asks to try Natural, read `https://www.natural.com/skill.md`, connect the hosted MCP server, and start the host's OAuth flow. After that:\n\n1. Have them sign up at `https://natural.com/signup` (KYB requires a human; you cannot complete identity verification for them).\n2. Install Natural's hosted MCP server yourself with no API-key header. The skill knows the right host path: Codex uses `codex mcp add` plus `codex mcp login` with Natural's MCP scope list (`payments:move external-accounts:link payments:direct agents:operate customers:invite`); Cursor uses `mcp.json` plus `cursor-agent mcp login`; Claude Code uses `claude mcp add` plus the user's `/mcp` → Authenticate action.\n3. Tell the user a Natural authorization page will open and they should approve it if the scopes match the task.\n4. Operate Natural on their behalf via MCP tools afterward.\n\nIf a host can run commands but has no MCP OAuth flow, fall back to the Natural CLI's browser OAuth (`natural login`) before any API key. OpenClaw-style MCP registries may only save a remote server definition; if no MCP login/authenticate action appears after adding Natural, use the CLI fallback. Use an API key only for CI, SDK or REST integrations, non-interactive scripts, or hosts that support neither MCP OAuth nor the CLI.\n\n**For documentation lookups, connect Natural's docs MCP server at `https://docs.natural.com/mcp`.** It is separate from the payments server at `mcp.natural.com` and requires no Natural account or credentials, so you can use it before OAuth or signup. It exposes tools to search these docs, read full pages, and pull the exact request shape of any endpoint from the OpenAPI spec.\n\n**Amount encoding differs by surface.** The REST API and SDKs use integer minor units: `1050` is $10.50 (see [Formats](https://docs.natural.com/api-reference/formats)). MCP tools use decimal strings at the currency's exact precision with a required currency code: `\"amount\": \"10.50\", \"currency\": \"USD\"` (see [MCP amounts and currencies](https://docs.natural.com/guides/platform/mcp#amounts-and-currencies)). The MCP server converts between the two at the boundary — never send integer cents to an MCP tool or a decimal string to the REST API.\n\nThe Dashboard at `https://natural.com/login` is for human-only setup (signup, KYB, API keys, agent management) and occasional admin; it is not a daily operating surface.\n\n## The one page to read\n\n- [Start here](https://docs.natural.com/guides/overview/start-here): canonical integration decision rule\n\n## Surfaces\n\n- [MCP](https://docs.natural.com/guides/platform/mcp): hosted at `mcp.natural.com`, OAuth-first with API-key fallback — the operator surface\n- [Docs MCP](https://docs.natural.com/mcp): hosted at `docs.natural.com/mcp`, no auth — search these docs, read full pages, and pull endpoint request shapes from the OpenAPI spec\n- [SDKs](https://docs.natural.com/guides/platform/sdks): `naturalpay` (Python) and `@naturalpay/sdk` (TypeScript) — for application developers\n- [CLI](https://docs.natural.com/guides/platform/cli): `natural` — for terminals, CI, agent harnesses\n- [REST API](https://docs.natural.com/api-reference/about): `api.natural.com`, Bearer auth, JSON:API envelope — for application developers without SDK coverage\n- [Dashboard](https://docs.natural.com/guides/platform/dashboard): web UI at `natural.com/login` — human-only setup gate, not a daily operating surface\n\n<!-- BEGIN GENERATED DOCUMENTATION DIRECTORY -->\n## Documentation directory\n\n### About / Overview\n\n- [Start here](https://docs.natural.com/guides/overview/start-here.md): Explore common use cases and integrate Natural immediately\n- [Compliance](https://docs.natural.com/guides/overview/compliance.md): Regulatory compliance and identity verification\n- [Security](https://docs.natural.com/guides/overview/security.md): How Natural protects your identity and banking details, and controls who can move money\n\n### About / Common use cases\n\n- [Store funds](https://docs.natural.com/guides/flows/wallets-and-balances.md): Hold money on Natural and let your agent manage it\n- [Send payments](https://docs.natural.com/guides/flows/send-money.md): Your agent pays anyone by email, phone, or handle\n- [Request money](https://docs.natural.com/guides/flows/collect-money.md): Your agent requests from anyone by email, phone, or handle\n- [Accept payments](https://docs.natural.com/guides/flows/accept-payments.md): Turn your agent into a merchant\n- [Payments over Voice](https://docs.natural.com/guides/flows/accept-voice.md): Turn a phone call into a PCI-compliant payment\n- [Issue cards](https://docs.natural.com/guides/flows/issue-cards.md): Give your agents cards to pay merchants online\n\n### About / Common use cases / Use as a card vault\n\n- [Use Natural as a card vault](https://docs.natural.com/guides/flows/card-vault.md): Save a user's card with one phone code and no identity check, then let your agent pay with it without seeing the card number\n- [Where your agent can check out](https://docs.natural.com/guides/cards/supported-checkouts.md): The payment processors and merchants where your agent can pay with a user's saved external card through Natural\n\n### About / Common use cases / Build a platform\n\n- [Overview](https://docs.natural.com/guides/flows/build-platform.md): Build a platform where your agent uses all of Natural's products on behalf of your customers with Connect\n- [Embedded finance](https://docs.natural.com/guides/flows/platform-embedded-finance.md): Request, collect, and pay funds inside each customer's own wallet, with balances held in the customer's name\n- [AP/AR](https://docs.natural.com/guides/flows/platform-ap-ar.md): Run a customer's payables and receivables end to end: collect what's owed, pay the bills, and reconcile both sides\ncurl: (23) Failure writing output to destination\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a0db1ca3f1869baa",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 39,
  "ts": "2026-11-03T17:16:31.573Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; timeout 20 curl -sSL https://docs.natural.com/llms.txt -o llms.txt; wc -l llms.txt; grep -inE \"pricing|cost|fee|rate|quickstart|api key|sandbox\" llms.txt | head -40"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-8287e3e9e4f00ab0",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 40,
  "ts": "2026-11-03T17:16:32.875Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "402 llms.txt\n11:The user completes required signup, identity verification, and OAuth consent. Verify with a successful read-only Natural tool call before reporting connected. Report configuration, authentication, tool availability, and account readiness separately. Continue with the full guidance below.\n13:<!-- BEGIN GENERATED AGENT INSTRUCTIONS -->\n18:> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.\n19:> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n21:<!-- END GENERATED AGENT INSTRUCTIONS -->\n23:**You (the agent reading this) are the MCP host the user is talking through.** If a user asks you to use, set up, or operate Natural for them:\n25:**Read the playbook, connect with OAuth, then operate via natural language.** If the user asks to try Natural, read `https://www.natural.com/skill.md`, connect the hosted MCP server, and start the host's OAuth flow. After that:\n28:2. Install Natural's hosted MCP server yourself with no API-key header. The skill knows the right host path: Codex uses `codex mcp add` plus `codex mcp login` with Natural's MCP scope list (`payments:move external-accounts:link payments:direct agents:operate customers:invite`); Cursor uses `mcp.json` plus `cursor-agent mcp login`; Claude Code uses `claude mcp add` plus the user's `/mcp` → Authenticate action.\n30:4. Operate Natural on their behalf via MCP tools afterward.\n32:If a host can run commands but has no MCP OAuth flow, fall back to the Natural CLI's browser OAuth (`natural login`) before any API key. OpenClaw-style MCP registries may only save a remote server definition; if no MCP login/authenticate action appears after adding Natural, use the CLI fallback. Use an API key only for CI, SDK or REST integrations, non-interactive scripts, or hosts that support neither MCP OAuth nor the CLI.\n34:**For documentation lookups, connect Natural's docs MCP server at `https://docs.natural.com/mcp`.** It is separate from the payments server at `mcp.natural.com` and requires no Natural account or credentials, so you can use it before OAuth or signup. It exposes tools to search these docs, read full pages, and pull the exact request shape of any endpoint from the OpenAPI spec.\n38:The Dashboard at `https://natural.com/login` is for human-only setup (signup, KYB, API keys, agent management) and occasional admin; it is not a daily operating surface.\n53:<!-- BEGIN GENERATED DOCUMENTATION DIRECTORY -->\n58:- [Start here](https://docs.natural.com/guides/overview/start-here.md): Explore common use cases and integrate Natural immediately\n133:- [Accept in Sandbox](https://docs.natural.com/guides/accept/test-in-sandbox.md): Test card payments and settlement without moving real money\n139:- [Test voice in Sandbox](https://docs.natural.com/guides/voice/test-in-sandbox.md): Simulate voice calls with one API call, or read a test card to the agent\n154:- [Authentication](https://docs.natural.com/api-reference/authentication.md): API keys, agent keys, OAuth, and Bearer authentication\n159:- [Rate limits](https://docs.natural.com/api-reference/rate-limits.md): API request rate limiting\n163:### API Reference / Overview / Our technology / Sandbox\n165:- [Sandbox](https://docs.natural.com/api-reference/sandbox/overview.md): Experience Natural without moving real money\n166:- [Payment fixtures](https://docs.natural.com/api-reference/sandbox/fixtures.md): Reserved test identifiers and synthetic counterparties for your sandbox organization\n167:- [Card fixtures](https://docs.natural.com/api-reference/sandbox/card-fixtures.md): Test successful payments, declines, 3-D Secure, subscriptions, settlement, cancels, and refunds in Sandbox\n168:- [Issued cards in Sandbox](https://docs.natural.com/api-reference/sandbox/issued-cards.md): Issue a test agent card, then simulate the merchant authorizing, capturing, reversing, expiring, and refunding purchases on it\n169:- [Sandbox from MCP, CLI, and SDKs](https://docs.natural.com/api-reference/sandbox/surfaces.md): Connect to the Natural Sandbox\n181:- [Sandbox: Invite a test customer](https://docs.natural.com/api-reference/simulations/create-test-customer.md): Create a synthetic Connect customer and pending invitations in Sandbox.\n182:- [Sandbox: Fund a Connect customer](https://docs.natural.com/api-reference/simulations/fund-test-customer.md): Add funds to a Connect customer's Sandbox balance.\n183:- [Sandbox: Accept a Connect invitation](https://docs.natural.com/api-reference/simulations/accept-customer-invitation.md): Accept a pending Connect invitation as a test customer in Sandbox.\n184:- [Sandbox: Decline a Connect invitation](https://docs.natural.com/api-reference/simulations/decline-customer-invitation.md): Decline a pending Connect invitation as a test customer in Sandbox.\n185:- [Sandbox: Revoke Connect access](https://docs.natural.com/api-reference/simulations/revoke-agent-connection.md): End an agent's access to a Connect customer in Sandbox.\n186:- [Sandbox: Disconnect a Connect customer](https://docs.natural.com/api-reference/simulations/disconnect-customer.md): End a test customer's full Connect relationship in Sandbox.\n194:- [Sandbox: Complete a payment claim](https://docs.natural.com/api-reference/simulations/complete-payment-claim.md): Complete a payment claim in Sandbox.\n210:- [Sandbox: Settle a realtime payment](https://docs.natural.com/api-reference/simulations/settle-realtime-payment.md): Drive a Sandbox realtime payment to settlement.\n211:- [Sandbox: Fail a realtime payment](https://docs.natural.com/api-reference/simulations/fail-realtime-payment.md): Drive a Sandbox realtime payment to a terminal network rejection.\n219:- [Sandbox: Complete a wire](https://docs.natural.com/api-reference/simulations/settle-wire.md): Drive a sandbox wire to completion.\n220:- [Sandbox: Reject a wire](https://docs.natural.com/api-reference/simulations/fail-wire.md): Drive a sandbox wire to a bank rejection.\n228:- [Sandbox: Deposit a check](https://docs.natural.com/api-reference/simulations/deposit-check.md): Drive a sandbox check to settlement on the deposit side.\n229:- [Sandbox: Fail a check](https://docs.natural.com/api-reference/simulations/fail-check.md): Drive a sandbox check to a terminal pre-settlement rejection.\n230:- [Sandbox: Bounce a check](https://docs.natural.com/api-reference/simulations/bounce-check.md): Drive a sandbox check through a non-terminal presentment return; it stays outstanding and depositable.\n231:- [Sandbox: Void a check](https://docs.natural.com/api-reference/simulations/void-check.md): Drive a sandbox check to CANCELED through a second presentment return after a failed reclear.\n232:- [Sandbox: Stop a check](https://docs.natural.com/api-reference/simulations/stop-check.md): Drive a sandbox check to CANCELED through a confirmed stop payment.\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-8287e3e9e4f00ab0",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 43,
  "ts": "2026-11-03T17:16:33.528Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; for p in guides/overview/start-here guides/platform/sdks api-reference/authentication quickstart api-reference/sandbox/surfaces; do echo \"########## $p\"; timeout 20 curl -sSL \"https://docs.natural.com/$p.md\" | head -c 4000; echo; done 2>&1 | head -300"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b809a69c917cfbdd",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 44,
  "ts": "2026-11-03T17:16:35.744Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "########## guides/overview/start-here\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.natural.com/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n> ## Agent Instructions\n> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.\n> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.\n> Use the Natural CLI for terminal and CI automation.\n> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.\n> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.\n\n# Start here\n\n> Explore common use cases and integrate Natural immediately\n\n## Let your agent connect Natural\n\nCopy this instruction into your agent:\n\n> 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.\n\nThe platform-specific instructions below remain available for manual setup.\n\n## Common use cases\n\n> [card] Store funds\n>\n> Hold money on Natural and let your agent manage it\n\n[Open](https://docs.natural.com/guides/flows/wallets-and-balances.md)\n\n> [card] Send payments\n>\n> Your agent pays anyone by email, phone, or handle\n\n[Open](https://docs.natural.com/guides/flows/send-money.md)\n\n> [card] Request money\n>\n> Your agent requests from anyone by email, phone, or handle\n\n[Open](https://docs.natural.com/guides/flows/collect-money.md)\n\n> [card] Accept payments\n>\n> Turn your agent into a merchant that can accept payments\n\n[Open](https://docs.natural.com/guides/flows/accept-payments.md)\n\n> [card] Issue cards\n>\n> Give your agents cards to pay merchants online (coming soon)\n\n[Open](https://docs.natural.com/guides/flows/issue-cards.md)\n\n> [card] Build a platform\n>\n> Move money on behalf of your customers\n\n[Open](https://docs.natural.com/guides/flows/build-platform.md)\n\n## Using Natural\n\n**1. Sign up**\n\nSign up at [natural.com/signup](https://natural.com/signup) and complete onboarding in the\n[dashboard](https://docs.natural.com/guides/platform/dashboard.md).\n\n**2. Connect an agent to Natural**\n\nIf an MCP host operates Natural for you, connect it to the hosted MCP server at\n`mcp.natural.com`. Pick your tool:\n\n> [tab] Everyday use\n>\n> > [accordion] Claude\n> >\n> > 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.\n> >\n> > 1. In [claude.ai](https://claude.ai) or the Claude Desktop app, open the sidebar, select **Customize**, and go to the **Connectors** tab.\n> >\n> > 2. Select **Add custom connector** and fill in the fields: name `Natural`, remote MCP server URL `https://mcp.natural.com`.\n> >\n> > 3. Select **Add**, then **Connect**. Your browser opens Natural's authorization page; approve it, and you are redirected back to Claude.\n> >\n> > 4. Try it in chat:\n> >\n> >    ```text theme={null}\n> >    Use Natural to check my wallet balance.\n> >    ```\n>\n> > [accordion] ChatGPT\n> >\n> > Custom plugins require a paid ChatGPT plan (Plus, Pro, Business, or Enterprise).\n> >\n> > 1. Select **Plugins** in the ChatGPT sidebar, then **Add → Add custom MCP server**.\n> >\n> > 2. Fill in the fields: name `Natural`, connection `https://mcp.natural.com`, authentication **OAuth**.\n> >\n> > 3. Check **I understand and want to continue** and select **Create as a plugin**.\n> >\n> > 4. Select **Connect Natural**, then approve Natur\n########## guides/platform/sdks\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.natural.com/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n> ## Agent Instructions\n> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.\n> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.\n> Use the Natural CLI for terminal and CI automation.\n> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.\n> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.\n\n# SDKs\n\n> Client libraries for building agents with Natural\n\nNatural has official SDKs for building agents, in Python and TypeScript.\n\n## Available tools\n\n> [card] Python SDK\n>\n> `pip install naturalpay`: Build agents in Python\n\n> [card] TypeScript SDK\n>\n> `npm install @naturalpay/sdk`: Build agents in TypeScript/JavaScript\n\n## Installation\n\n```bash Python theme={null}\npip install naturalpay\n# or\nuv add naturalpay\n```\n\n```bash TypeScript theme={null}\nnpm install @naturalpay/sdk\n# or\nyarn add @naturalpay/sdk\n```\n\n## Quick start\n\n```python Python theme={null}\nfrom naturalpay import Natural\n\n# Agent key from NATURAL_API_KEY; instance_id identifies this run.\nclient = Natural(instance_id=\"invoice-run-1234\")\n\n# Create a payment on behalf of a customer\npayment = client.payments.create(\n    amount=10000,  # cents - $100.00\n    currency=\"USD\",\n    counterparty={\"type\": \"email\", \"value\": \"ada@example.com\"},\n    description=\"Invoice #1234\",\n    customer_party_id=\"pty_019cd1798d627ad9bc302511c4f2c115\",\n    idempotency_key=\"pay-invoice-1234\",\n)\n\nprint(payment.data.id)\nprint(payment.data.attributes.status)\n```\n\n```typescript TypeScript theme={null}\nimport Natural from \"@naturalpay/sdk\";\n\n// One client per run: instanceId names the run, and the SDK sends it\n// as X-Instance-ID on every call this client makes.\nconst client = new Natural({ instanceId: \"invoice-run-1234\" }); // agent key from NATURAL_API_KEY\n\n// Create a payment on behalf of a customer\nconst payment = await client.payments.create({\n  amount: 10000, // cents - $100.00\n  currency: \"USD\",\n  counterparty: { type: \"email\", value: \"ada@example.com\" },\n  description: \"Invoice #1234\",\n  customerPartyId: \"pty_019cd1798d627ad9bc302511c4f2c115\",\n  idempotencyKey: \"pay-invoice-1234\",\n});\n\nconsole.log(payment.data.id);\nconsole.log(payment.data.attributes.status);\n```\n\n## Agent authentication\n\nBoth SDKs accept either credential type in `NATURAL_API_KEY` (see [Authentication](https://docs.natural.com/api-reference/authentication.md)):\n\n* **Agent key** (`ak_ntl_…`): Bound to one agent. Requests resolve as that agent automatically, so do not pass an agent ID (a conflicting one is rejected). An instance ID is required for money movement (payments and payment cancellation, Direct, transfers, deposits, withdrawals, and payment-request fulfillment) so each agent run is auditable. In Python, pass `instance_id` to the client constructor and build a client per run. In TypeScript, set it on the constructor or per call.\n* **API key** (`sk_ntl_…`): Party-scoped. Calls act as your party and cannot act as an agent (see [Authentication](https://docs.natural.com/api-reference/authentication.md#agent-keys)).\n\n### With an agent key\n\n```python Python theme={null}\n# NATURAL_API_KEY=ak_ntl_prod_... (the agent's key)\n# One client per run: instance_id names the run, and the SDK sends it\n# as X-Instance-ID on every call this client makes.\nclient = Natural(instance_id=\"vendor-payouts-q1\")\n\npayment = client.payments.create(\n    counterparty={\"type\": \"email\", \"value\": \"ada@example.com\"},\n    amount=50000,  # cents ($500.00)\n    description=\"Vendor payment\",\n    customer_party_id=\"pty_019cd1798d627ad9b\n########## api-reference/authentication\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.natural.com/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n> ## Agent Instructions\n> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.\n> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.\n> Use the Natural CLI for terminal and CI automation.\n> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.\n> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.\n\n# Authentication\n\n> API keys, agent keys, OAuth, and Bearer authentication\n\nThe Natural API uses Bearer authentication. Include your credential in the `Authorization` header of every request:\n\n```bash theme={null}\ncurl https://api.natural.com/payments \\\n  -H \"Authorization: Bearer sk_ntl_prod_abc123...\"\n```\n\nThe same credential authenticates the [SDKs](https://docs.natural.com/guides/platform/sdks.md), the [CLI](https://docs.natural.com/guides/platform/cli.md), and REST calls. AI hosts using [MCP](https://docs.natural.com/guides/platform/mcp.md) authenticate with browser OAuth by default.\n\n## Credential modes\n\nNatural supports four credential modes. They differ in **who the request acts as** and **how agent identity is established**:\n\n| Mode | Prefix / flow | Acts as |\n| - | - | - |\n| [API key](#api-keys) | `sk_ntl_…` | Your party |\n| [Agent key](#agent-keys) | `ak_ntl_…` | One specific agent, verified |\n| [User-scoped MCP OAuth](https://docs.natural.com/guides/platform/mcp.md) | Browser OAuth consent | The authorizing user |\n| [Agent-scoped MCP OAuth](https://docs.natural.com/guides/platform/mcp.md) | Browser OAuth consent | Selected or new agent, verified |\n\nKey rules:\n\n* **Bound credentials carry verified agent identity.** With an agent key or agent-scoped OAuth grant, Natural resolves the agent from the credential itself. This is the only way to act as an agent: a party API key or user credential always acts as the party.\n* **User-scoped money movement is valid.** Dashboard users and party API keys can move money without any agent attribution.\n* **Agent-attributed money movement requires `X-Instance-ID`.** See [instance attribution](#instance-attribution-for-agent-money-movement).\n\n## API keys\n\nAPI keys are party-scoped credentials in the format `sk_ntl_{environment}_{secret}`:\n\n| Prefix | Environment | Base URL |\n| - | - | - |\n| `sk_ntl_prod_` | Production | `https://api.natural.com` |\n| `sk_ntl_sandbox_` | Sandbox | `https://api.sandbox.natural.com` |\n\nAgent keys carry the same environment segment (`ak_ntl_prod_`, `ak_ntl_sandbox_`). See the [Sandbox](https://docs.natural.com/api-reference/sandbox/overview.md).\n\nAn API key acts as your party and cannot act as an agent. To act as an agent, authenticate with an agent key or an agent-scoped OAuth grant.\n\n### Creating API keys\n\nCreate API keys from the [dashboard](https://docs.natural.com/guides/platform/dashboard.md) or via [`POST /api-keys`](https://docs.natural.com/api-reference/api-keys/create-api-key). The key secret is shown once; store it immediately.\n\nEach key can be scoped to a subset of permissions. Scope a key down to exactly what the integration needs, for example a read-only key or one limited to payments:\n\n```json theme={null}\n{\n  \"data\": {\n    \"attributes\": {\n      \"name\": \"Carrier Payment Agent\",\n      \"scopes\": [\"agents.read\", \"payments.create\", \"payments.read\"]\n    }\n  }\n}\n```\n\n## Agent keys\n\nAgent keys are credentials bound to exactly one of your [agents](https://docs.natural.com/guides/concepts/agents.md), in the format `ak_ntl_{environment}_{secret}`. Requests authenticated with an agent key resolve as that agent, verified by the creden\n########## quickstart\n> ## Documentation Index\n> Fetch the complete documentation index at: https://docs.natural.com/llms.txt\n> Use this file to discover all available pages before exploring further.\n\n> ## Agent Instructions\n> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.\n> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.\n> Use the Natural CLI for terminal and CI automation.\n> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.\n> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.\n\n# Start here\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b809a69c917cfbdd",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 47,
  "ts": "2026-11-03T17:16:38.124Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; echo \"=== pypi naturalpay\"; timeout 20 curl -sS https://pypi.org/pypi/naturalpay/json -o np.json -w \"%{http_code}\\n\"; python3 -c \"\nimport json;d=json.load(open('/tmp/np.json'));i=d['info'];print(i['name'],i['version'],i['summary']);print(i['home_page'],i.get('project_urls'))\" 2>&1 | head -20; echo \"=== npm\"; timeout 20 curl -sS https://registry.npmjs.org/@naturalpay%2Fsdk | head -c 400; echo; echo \"=== pricing pages\"; for u in https://www.natural.com/pricing https://natural.com/pricing; do echo \"$u -> $(timeout 12 curl -sSL -o /dev/null -w '%{http_code}' $u)\"; done"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-821b868c49adcaf3",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 48,
  "ts": "2026-11-03T17:16:41.275Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "=== pypi naturalpay\n200\nnaturalpay 1.6.54 None\nNone {'Repository': 'https://github.com/naturalpay/naturalpay-python'}\n=== npm\n{\"_id\":\"@naturalpay/sdk\",\"_rev\":\"186-afd8b5d5547ca3bb41082428c708ed95\",\"name\":\"@naturalpay/sdk\",\"dist-tags\":{\"backport\":\"1.5.0\",\"latest\":\"1.6.54\"},\"versions\":{\"1.0.1\":{\"name\":\"@naturalpay/sdk\",\"version\":\"1.0.1\",\"_id\":\"@naturalpay/sdk@1.0.1\",\"maintainers\":[{\"name\":\"bhargavnatural\",\"email\":\"bhargav@natural.co\"}],\"homepage\":\"https://github.com/naturalpay/naturalpay-ts#readme\",\"bugs\":{\"url\":\"https://gcurl: (23) Failure writing output to destination\n\n=== pricing pages\nhttps://www.natural.com/pricing -> 200\nhttps://natural.com/pricing -> 200\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-821b868c49adcaf3",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 51,
  "ts": "2026-11-03T17:16:42.424Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; timeout 20 curl -sSL https://www.natural.com/pricing -o pricing.html; grep -oE 'src=\"[^\"]+\\.js\"' pricing.html | sort -u; echo ---; ls; "
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-9a7542340a18979b",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 52,
  "ts": "2026-11-03T17:16:43.227Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "grep: pricing.html: binary file matches\n---\nalg-duplex\nllms.txt\nmkt.js\nnp.json\nopencode\npricing.html\nsystemd-private-a899c44729714dffa2c40386ace2ebb5-systemd-logind.service-aS7Bzb\nsystemd-private-a899c44729714dffa2c40386ace2ebb5-systemd-resolved.service-m9NpBo\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-9a7542340a18979b",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 55,
  "ts": "2026-11-03T17:16:44.515Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; timeout 20 curl -sSL --compressed https://www.natural.com/pricing -o pricing.html; grep -oE '(src|href)=\"[^\"]+\\.(js|css)\"' pricing.html | sort -u | head; echo \"=== text\"; sed 's/<[^>]*>/ /g' pricing.html | tr -s ' \\n' ' \\n' | head -c 1500"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-80e5eb0f4d280f58",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 56,
  "ts": "2026-11-03T17:16:44.845Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "grep: pricing.html: binary file matches\n=== text\n Pricing — Natural (function(w,d,s,l,i){\nif(w.location.pathname.startsWith(\"/customer-view/\"))return;\ntry{if(w.sessionStorage.getItem(\"natural-customer-view-session-id\"))return;}catch{return;}w[l]=w[l]||[];w[l].push({'gtm.start':\nnew Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],\nj=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=\n'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);\n})(window,document,'script','dataLayer','GTM-MC5QH7WB'); {\"@context\":\"https://schema.org\",\"@type\":\"Organization\",\"name\":\"Natural\",\"url\":\"https://www.natural.com\",\"logo\":\"https://www.natural.com/assets/brand/natural-logo.svg\",\"description\":\"Natural is the agentic payments platform powering frictionless money movement between agents, businesses, and consumers.\",\"foundingDate\":\"2025-08-12\",\"sameAs\":[\"https://x.com/naturalpay\",\"https://www.linkedin.com/company/naturalpay\"]} Products Features Company Pricing Docs Login Sign up for free Simple, scalable pricing Sign up for free Talk to the team Accounts Wallet Vault Move money Pay Request Transfer Direct Cards & credit Accept Cards Credit Developer & billing Connect Voice Bill Charge Accounts Start now Consumer Business Enterprise Wallets FDIC-insured¹ wallets for agents Consumer Free Business Free Enterprise Free Vault One-way accounts for agents to move money in, never out Consumer Free Business Free Enterprise Free Move money Start now Consumer Business Enterprise Pay S",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-80e5eb0f4d280f58",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 59,
  "ts": "2026-11-03T17:16:46.679Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; sed 's/<script[^>]*>[^<]*<\\/script>//g' pricing.html | sed 's/<[^>]*>/\\n/g' | grep -vE '^\\s*$' | sed -n '20,400p' | tr '\\n' '|' | sed 's/||*/|/g' | fold -w 200 | head -80"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-ac3b6a4ca0cd5d18",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 60,
  "ts": "2026-11-03T17:16:46.679Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "Wallet|Vault|Move money|Pay|Request|Transfer|Direct|Cards & credit|Accept|Cards|Credit|Developer & billing|Connect|Voice|Bill|Charge|Accounts|Start now|Consumer|Business|Enterprise|Wallets|FDI\nC-insured¹ wallets for agents|Consumer|Free|Business|Free|Enterprise|Free|Vault|One-way accounts for agents to move money in, never out|Consumer|Free|Business|Free|Enterprise|Free|Move money|Start no\nw|Consumer|Business|Enterprise|Pay|Send money to an agent, business, or consumer|Consumer|Free|Business|0.1% or 10 bps|Enterprise|Contact us|Request|Collect money from an agent, business, or consumer|\nConsumer|Free|Business|0.1% or 10 bps|Enterprise|Contact us|Transfer|Move funds between internal and external accounts|Consumer|Free|Standard|1.5%|Instant|Business|Free|Standard|1.5%|Instant|Enterpris\ne|Free|Standard|Contact us|Instant|Direct|Let your agents choose the best way to pay|ACH|For high-volume payments, settled next day|Consumer|0.5%|Business|0.5%|Enterprise|Contact us|Wire|For large-val\nue payments, settled same day|Consumer|0.25%|Business|0.25%|Enterprise|Contact us|Realtime|For urgent payments, settled in seconds|Consumer|1.5%|Business|1.5%|Enterprise|Contact us|Cards & credit|\nStart now|Consumer|Business|Enterprise|Accept|Soon|Turn your agent into a merchant to process payments|Consumer|N/A|Standard|N/A|MOR|Business|2.9% + 30¢|Standard|Contact us|MOR|Enterprise|Contact us|\nStandard|Contact us|MOR|Cards|Soon|Issue debit and charge cards for agents|Consumer|Free|Business|Free|Enterprise|Free|Credit|Soon|Give agents access to lines of credit|Consumer|N/A|Base|N/A|Card|Busi\nness|3% or 300 bps|Base|$0|Card|Enterprise|Custom|Base|$0|Card|Developer & billing|Start now|Consumer|Business|Enterprise|Connect|Build platforms and marketplaces on Natural|Consumer|Free|Business\n|Free|Enterprise|Free|Voice|Soon|Securely collect card details over the phone|Consumer|N/A|Base|N/A|With Accept*|Business|$1K/month|Base|Waived|With Accept*|Enterprise|Contact us|Base|Waived|With Acce\npt*|Billing|Soon|Usage and success based billing for agents|Consumer|N/A|Business|0.5% or 50 bps|Enterprise|Contact us|Charge|Soon|Use popular APIs and pay per call|Consumer|0.1% or 10 bps|Business|0.\n1% or 10 bps|Enterprise|Contact us|Payments made Natural.|Start building on Natural today|Sign up for free|Talk to the team|Products|Wallets|Vault|Pay|Request|Transfer|Direct|Accept|Cards|Credit|Voice\n|Connect|Bill|Charge|Features|Identity|Observability|Disputes|Compliance|Developers|Guides|Documentation|API Status|Join Slack|Company|About|Careers|Blog|Pricing|Contact|Connect|X|LinkedIn|Instagram|G\nitHub|Email|Services Agreement|Privacy Policy|Sub-processors|Authorized Use Policy|Disclosures|Natural is a financial technology company, not a bank. Wallet Accounts and banking services are provided \nby Column N.A., Member FDIC.|1 |Natural is a financial technology company, not an FDIC-insured depository institution. FDIC deposit insurance covers the failure of an insured depository institution. C\nertain conditions must be satisfied for pass-through FDIC insurance to apply. Deposits in Wallet accounts are FDIC-insured through Column N.A., Member FDIC, and Column’s|Sweep Program Network Banks|\n.|© 2025-2026 Natural AI, Inc.|",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-ac3b6a4ca0cd5d18",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 63,
  "ts": "2026-11-03T17:16:48.623Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; timeout 20 curl -sSL --compressed https://docs.natural.com/api-reference/sandbox/overview.md | sed -n '10,80p'; echo \"########## surfaces\"; timeout 20 curl -sSL --compressed https://docs.natural.com/api-reference/sandbox/surfaces.md | sed -n '10,90p'"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b97df8eed06e3785",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 64,
  "ts": "2026-11-03T17:16:49.275Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.\n\n# Sandbox\n\n> Experience Natural without moving real money\n\n![The Natural dashboard in sandbox mode](https://mintcdn.com/natural-b3c9dd77/pPnF-06H78Do1npA/assets/heroes/sandbox-hero.jpg?fit=max\\&auto=format\\&n=pPnF-06H78Do1npA\\&q=85\\&s=981aae4ea7465d69aff3a62e86889e1a)\n\nThe sandbox is a complete Natural environment that functions like production.\n\nPoint your integration at the sandbox base URL with a sandbox key:\n\n```text theme={null}\nhttps://api.sandbox.natural.com\n```\n\nKeys carry their environment in the prefix (`sk_ntl_sandbox_...`, `ak_ntl_sandbox_...`) and never work anywhere else.\n\nSandbox keys come from the [dashboard](https://docs.natural.com/guides/platform/dashboard.md): open the account menu in the bottom-left corner (the same menu you sign out from) and flip the **Sandbox** toggle.\n\n## How it behaves\n\n* **No separate onboarding for your organization.** Your verified Natural organization carries over automatically. Test customers become verified when you [accept a pending invitation](https://docs.natural.com/api-reference/simulations/accept-customer-invitation.md).\n* **Money moves instantly.** Transfers and payments settle as soon as you make them. Card payments are the exception: they wait until you [simulate settlement](https://docs.natural.com/api-reference/simulations/settle-card-payment.md).\n* **Isolated.** You can reach your own parties and your [fixtures](https://docs.natural.com/api-reference/sandbox/fixtures.md), nothing else. No other sandbox organization can see or touch your data.\n\n## What you can do\n\n| Surface | What you can do |\n| - | - |\n| Connect | [Invite a test customer](https://docs.natural.com/api-reference/simulations/create-test-customer.md), [accept](https://docs.natural.com/api-reference/simulations/accept-customer-invitation.md) or [decline](https://docs.natural.com/api-reference/simulations/decline-customer-invitation.md) the pending invitation, then [fund it](https://docs.natural.com/api-reference/simulations/fund-test-customer.md), [revoke an agent](https://docs.natural.com/api-reference/simulations/revoke-agent-connection.md), or [disconnect it](https://docs.natural.com/api-reference/simulations/disconnect-customer.md) |\n| Payments | [Complete a payment claim](https://docs.natural.com/api-reference/simulations/complete-payment-claim.md) held for an unregistered recipient |\n| Payment requests | [Fulfill](https://docs.natural.com/api-reference/simulations/fulfill-payment-request.md) or [decline](https://docs.natural.com/api-reference/simulations/decline-payment-request.md) a request as the payer |\n| Bank accounts | [Link a test bank account](https://docs.natural.com/api-reference/simulations/link-test-bank-account.md) to your own party |\n| Direct | [Settle](https://docs.natural.com/api-reference/simulations/settle-wire.md) or [fail](https://docs.natural.com/api-reference/simulations/fail-wire.md) a wire, [settle](https://docs.natural.com/api-reference/simulations/settle-realtime-payment.md) or [fail](https://docs.natural.com/api-reference/simulations/fail-realtime-payment.md) a realtime payment |\n| Accept | Pay a checkout link with a [test card](https://docs.natural.com/api-reference/sandbox/card-fixtures.md), then [settle the card payment](https://docs.natural.com/api-reference/simulations/settle-card-payment.md) into your wallet; see [Test Accept in Sandbox](https://docs.natural.com/guides/accept/test-in-sandbox.md) |\n\nSandbox endpoints live under `/simulations/*` and appear in a Simulations group under each resource they test. The Connect, payment, payment-request, and bank-account actions above are also available from MCP, the SDKs, and the CLI; see [Sandbox from MCP, CLI, and SDKs](https://docs.natural.com/api-reference/sandbox/surfaces.md).\n\n\nThis documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.########## surfaces\n> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.\n\n# Sandbox from MCP, CLI, and SDKs\n\n> Connect to the Natural Sandbox\n\nSwitch the [dashboard](https://docs.natural.com/guides/platform/dashboard.md) to Sandbox to get a sandbox key (`sk_ntl_sandbox_…`, `ak_ntl_sandbox_…`).\n\nThe simulation actions listed below are available on every surface:\n\n| Surface | Where simulations live |\n| - | - |\n| REST API | [`POST /simulations/*`](https://docs.natural.com/api-reference/simulations/create-test-customer), grouped with the resources they test |\n| SDKs | `client.simulations` in [TypeScript and Python](https://docs.natural.com/guides/platform/sdks.md) |\n| CLI | [`natural simulations <verb>`](https://docs.natural.com/guides/platform/cli) commands |\n| MCP | Sandbox-only tools on `mcp.sandbox.natural.com` |\n\n## SDKs\n\nPoint the client at the sandbox and put your agent's sandbox key in `NATURAL_API_KEY`. Your integration code is unchanged; `client.simulations` acts as the counterparty.\n\n```python Python theme={null}\nfrom naturalpay import Natural\n\n# NATURAL_API_KEY=ak_ntl_sandbox_...\nclient = Natural(\n    instance_id=\"sandbox-run-1\",\n    base_url=\"https://api.sandbox.natural.com\",\n)\n\n# Invite a test customer; one pending invitation is created per agent\ninvited = client.simulations.invite_customer(\n    agent_ids=[\"agt_019cd1798d637a4da75dce386343931d\"],\n    permissions=[\"payments.create\", \"payments.read\", \"wallets.read\"],\n    idempotency_key=\"test-customer-1\",\n)\ncustomer_id = invited.meta.customer.party_id\n\n# Accept the invitation as the test customer\nclient.simulations.accept_customer_invitation(\n    invitation_id=invited.data[0].id,\n    party_id=customer_id,\n    idempotency_key=\"accept-invitation-1\",\n)\n\n# Fund it so payments on its behalf can settle\nclient.simulations.fund_customer(\n    customer_id=customer_id,\n    amount=250000,  # cents - $2,500.00\n    currency=\"USD\",\n    idempotency_key=\"fund-customer-1\",\n)\n\n# Run your integration exactly as it runs in production\npayment = client.payments.create(\n    amount=10000,\n    currency=\"USD\",\n    counterparty={\"type\": \"email\", \"value\": \"payment-recipient@sandbox.natural.test\"},\n    customer_party_id=customer_id,\n    idempotency_key=\"pay-1\",\n)\n```\n\n```typescript TypeScript theme={null}\nimport Natural from \"@naturalpay/sdk\";\n\n// NATURAL_API_KEY=ak_ntl_sandbox_...\nconst client = new Natural({\n  instanceId: \"sandbox-run-1\",\n  baseUrl: \"https://api.sandbox.natural.com\",\n});\n\n// Invite a test customer; one pending invitation is created per agent\nconst invited = await client.simulations.inviteCustomer({\n  agentIds: [\"agt_019cd1798d637a4da75dce386343931d\"],\n  permissions: [\"payments.create\", \"payments.read\", \"wallets.read\"],\n  idempotencyKey: \"test-customer-1\",\n});\nconst customerId = invited.meta.customer.partyId;\n\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b97df8eed06e3785",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 67,
  "ts": "2026-11-03T17:16:51.769Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp && python3 -V && timeout 180 pip install --quiet naturalpay 2>&1 | tail -3; python3 -c \"\nimport naturalpay, inspect\nfrom naturalpay import Natural\nprint('version', getattr(naturalpay,'__version__','?'))\nsig=inspect.signature(Natural.__init__); print('Natural.__init__', sig)\nprint('resources:', [a for a in dir(Natural) if not a.startswith('_')])\n\""
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-81571f90c8c516a2",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 68,
  "ts": "2026-11-03T17:16:59.470Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "Python 3.12.3\n\n[notice] A new release of pip is available: 26.2.1 -> 26.3\n[notice] To update, run: /opt/freestyle/python/bin/python3 -m pip install --upgrade pip\nversion 1.6.54\nNatural.__init__ (self, *, base_url: 'typing.Optional[str]' = None, environment: 'NaturalEnvironment' = <NaturalEnvironment.PRODUCTION: 'https://api.natural.com'>, instance_id: 'typing.Optional[str]' = None, token: 'typing.Optional[typing.Union[str, typing.Callable[[], str]]]' = None, headers: 'typing.Optional[typing.Dict[str, str]]' = None, timeout: 'typing.Optional[float]' = None, max_retries: 'typing.Optional[int]' = None, stream_reconnection_enabled: 'typing.Optional[bool]' = None, max_stream_reconnection_attempts: 'typing.Optional[int]' = None, follow_redirects: 'typing.Optional[bool]' = True, httpx_client: 'typing.Optional[httpx.Client]' = None, logging: 'typing.Optional[typing.Union[LogConfig, Logger]]' = None)\nresources: ['ach', 'agent_keys', 'agentic_payments', 'agents', 'api_keys', 'approvals', 'card_payments', 'card_sessions', 'chargebacks', 'check', 'customers', 'events', 'external_accounts', 'external_parties', 'external_party_accounts', 'invitation_links', 'invitations', 'merchant_reports', 'parties', 'payment_intents', 'payment_requests', 'payments', 'realtime', 'refunds', 'simulations', 'transactions', 'transfers', 'voice_sessions', 'wallets', 'webhooks', 'wire']\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-81571f90c8c516a2",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 71,
  "ts": "2026-11-03T17:17:01.709Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; python3 -c \"\nimport inspect\nfrom naturalpay import Natural\nc=Natural(token='sk_ntl_sandbox_dummy')\nfor r,m in [('wallets','list'),('customers','list'),('simulations','invite_customer'),('simulations','fund_customer'),('payments','create')]:\n    res=getattr(c,r); f=getattr(res,m,None)\n    print(r+'.'+m, inspect.signature(f) if f else 'MISSING')\n\" 2>&1 | head -20"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-84ffcd9646b99a55",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 72,
  "ts": "2026-11-03T17:17:03.756Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "wallets.list (*, customer_party_id: Optional[str] = None, limit: Optional[int] = None, cursor: Optional[str] = None, request_options: Optional[naturalpay.core.request_options.RequestOptions] = None) -> naturalpay.wallets.types.wallet.Wallet\ncustomers.list (*, cursor: Optional[str] = None, limit: Optional[int] = None, status: Union[Literal['active', 'revoked', 'all'], Any, NoneType] = None, request_options: Optional[naturalpay.core.request_options.RequestOptions] = None) -> naturalpay.core.pagination.SyncPager[naturalpay.customers.types.list_customers_response_data_item.ListCustomersResponseDataItem, naturalpay.customers.types.customer.Customer]\nsimulations.invite_customer (*, idempotency_key: str, agent_ids: Sequence[str], permissions: Union[List[Union[Literal['disputes.read', 'disputes.create', 'payments.read', 'payments.create', 'external_parties.read', 'external_parties.create', 'direct.read', 'direct.create', 'external_accounts.create', 'wallets.read', 'wallets.balance', 'wallets.create', 'wallets.update', 'wallets.fund', 'wallets.transfer', 'wallets.withdraw', 'party.read', 'party.update', 'payment_intents.create', 'payment_intents.read', 'card_payments.read', 'refunds.read', 'refunds.create', 'voice_sessions.read', 'voice_sessions.create', 'chargebacks.read', 'chargebacks.respond', 'mandates.read', 'enrollment.read', 'cards.read', 'saved_cards.use'], Any]], naturalpay.simulations.types.invite_customer_simulations_request_permissions_type.InviteCustomerSimulationsRequestPermissionsType], type: Union[Literal['PERSON', 'ORG'], Any, NoneType] = Ellipsis, message: Optional[str] = Ellipsis, redirect_url: Optional[str] = Ellipsis, business_name: Optional[str] = Ellipsis, request_options: Optional[naturalpay.core.request_options.RequestOptions] = None) -> naturalpay.simulations.types.invite_customer_simulations_response.InviteCustomerSimulationsResponse\nsimulations.fund_customer (customer_id: str, *, idempotency_key: str, amount: int, currency: Union[Literal['USD'], Any, NoneType] = Ellipsis, wallet_id: Optional[str] = Ellipsis, request_options: Optional[naturalpay.core.request_options.RequestOptions] = None) -> naturalpay.simulations.types.fund_customer_simulations_response.FundCustomerSimulationsResponse\npayments.create (*, idempotency_key: str, amount: int, counterparty: Annotated[Union[naturalpay.payments.types.create_payments_request_counterparty.CreatePaymentsRequestCounterparty_Email, naturalpay.payments.types.create_payments_request_counterparty.CreatePaymentsRequestCounterparty_Phone, naturalpay.payments.types.create_payments_request_counterparty.CreatePaymentsRequestCounterparty_PartyId, naturalpay.payments.types.create_payments_request_counterparty.CreatePaymentsRequestCounterparty_AgentId, naturalpay.payments.types.create_payments_request_counterparty.CreatePaymentsRequestCounterparty_Handle], FieldInfo(annotation=NoneType, required=True, discriminator='type')], customer_party_id: Optional[str] = Ellipsis, currency: Union[Literal['USD'], Any, NoneType] = Ellipsis, description: Optional[str] = Ellipsis, tags: Optional[Dict[str, str]] = Ellipsis, wallet_id: Optional[str] = Ellipsis, skip_recipient_setup: Optional[bool] = Ellipsis, disable_notifications: Optional[Sequence[Union[Literal['recipient'], Any]]] = Ellipsis, request_options: Optional[naturalpay.core.request_options.RequestOptions] = None) -> naturalpay.payments.types.new_payment.NewPayment\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-84ffcd9646b99a55",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 75,
  "ts": "2026-11-03T17:17:05.556Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; python3 -c \"\nimport inspect\nfrom naturalpay import Natural\nc=Natural(token='x')\nfor r,m in [('agents','list'),('simulations','accept_customer_invitation')]:\n    print(r+'.'+m, inspect.signature(getattr(getattr(c,r),m)))\nprint([a for a in dir(c.simulations) if not a.startswith('_')])\n\" 2>&1 | head"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-916c4ad1d82f65de",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 76,
  "ts": "2026-11-03T17:17:06.914Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "agents.list (*, status: Union[Literal['ACTIVE', 'REVOKED'], Any, NoneType] = None, limit: Optional[int] = None, cursor: Optional[str] = None, request_options: Optional[naturalpay.core.request_options.RequestOptions] = None) -> naturalpay.core.pagination.SyncPager[naturalpay.agents.types.list_agents_response_data_item.ListAgentsResponseDataItem, naturalpay.agents.types.agent.Agent]\nsimulations.accept_customer_invitation (invitation_id: str, *, idempotency_key: str, party_id: str, request_options: Optional[naturalpay.core.request_options.RequestOptions] = None) -> naturalpay.simulations.types.accept_customer_invitation_simulations_response.AcceptCustomerInvitationSimulationsResponse\n['accept_customer_invitation', 'bounce_check', 'complete_payment_claim', 'decline_customer_invitation', 'decline_payment_request', 'deliver_check', 'deposit_check', 'disconnect_customer', 'fail_check', 'fail_realtime', 'fail_wire', 'fulfill_payment_request', 'fund_customer', 'invite_customer', 'link_external_account', 'return_check_to_sender', 'revoke_agent_connection', 'settle_card_payment', 'settle_realtime', 'settle_wire', 'stop_check', 'void_check', 'with_raw_response']\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-916c4ad1d82f65de",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 83,
  "ts": "2026-11-03T17:17:13.462Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; python3 -c \"\nfrom naturalpay.wallets.types.wallet import Wallet\nimport inspect\nprint(Wallet.__fields__.keys() if hasattr(Wallet,'__fields__') else dir(Wallet))\ntry:\n  from naturalpay.wallets.types.wallet_attributes import WalletAttributes as A; print('attrs', A.__fields__.keys())\nexcept Exception as e: print('attrs?',e)\nfrom naturalpay.core import ApiError; print('ApiError ok', [a for a in dir(ApiError) if not a.startswith('_')][:12])\n\""
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-8375be04c5cc3934",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 84,
  "ts": "2026-11-03T17:17:13.815Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "<string>:4: PydanticDeprecatedSince20: The `__fields__` attribute is deprecated, use the `model_fields` class property instead. Deprecated in Pydantic V2.0 to be removed in V3.0. See Pydantic V2 Migration Guide at https://errors.pydantic.dev/2.13/migration/\ndict_keys(['data', 'meta'])\nattrs? No module named 'naturalpay.wallets.types.wallet_attributes'\nApiError ok ['add_note', 'args', 'with_traceback']\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-8375be04c5cc3934",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 87,
  "ts": "2026-11-03T17:17:15.664Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; python3 -c \"\nfrom naturalpay.core import ApiError\nimport inspect; print(inspect.signature(ApiError.__init__)); print(inspect.getsource(ApiError)[:800])\nfrom naturalpay.wallets.types import wallet_data_item as W\nprint(W.WalletDataItem.model_fields.keys())\n\" 2>&1 | grep -v Deprecat"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a6ac0182d13085b0",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 88,
  "ts": "2026-11-03T17:17:15.664Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "Traceback (most recent call last):\n  File \"<string>\", line 4, in <module>\nImportError: cannot import name 'wallet_data_item' from 'naturalpay.wallets.types' (/opt/freestyle/python/lib/python3.12/site-packages/naturalpay/wallets/types/__init__.py)\n(self, *, headers: Optional[Dict[str, str]] = None, status_code: Optional[int] = None, body: Any = None) -> None\nclass ApiError(Exception):\n    headers: Optional[Dict[str, str]]\n    status_code: Optional[int]\n    body: Any\n\n    def __init__(\n        self,\n        *,\n        headers: Optional[Dict[str, str]] = None,\n        status_code: Optional[int] = None,\n        body: Any = None,\n    ) -> None:\n        self.headers = headers\n        self.status_code = status_code\n        self.body = body\n\n    def __str__(self) -> str:\n        return f\"headers: {self.headers}, status_code: {self.status_code}, body: {self.body}\"\n\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a6ac0182d13085b0",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 91,
  "ts": "2026-11-03T17:17:17.869Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; python3 -c \"\nimport naturalpay.wallets.types as t; print([n for n in dir(t) if 'allet' in n])\nfrom naturalpay.wallets.types.wallet import Wallet\nprint(Wallet.model_fields['data'])\n\" 2>&1 | grep -v Deprecat"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-91746e7b8b36a7bc",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 92,
  "ts": "2026-11-03T17:17:18.308Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "['AttachAgentWalletsResponse', 'AttachAgentWalletsResponseData', 'AttachAgentWalletsResponseDataAttributes', 'AttachAgentWalletsResponseDataAttributesLimits', 'AttachAgentWalletsResponseDataAttributesStatus', 'AttachAgentWalletsResponseDataMeta', 'AttachAgentWalletsResponseDataMetaWalletAccess', 'AttachAgentWalletsResponseDataMetaWalletAccessAccessType', 'AttachAgentWalletsResponseDataRelationships', 'AttachAgentWalletsResponseDataRelationshipsParty', 'AttachAgentWalletsResponseDataRelationshipsPartyData', 'AttachAgentWalletsResponseDataRelationshipsPartyDataType', 'AttachAgentWalletsResponseDataType', 'CreateWalletsResponse', 'CreateWalletsResponseData', 'CreateWalletsResponseDataAttributes', 'CreateWalletsResponseDataAttributesBalance', 'CreateWalletsResponseDataAttributesBalanceCurrency', 'CreateWalletsResponseDataAttributesClaims', 'CreateWalletsResponseDataAttributesDepositInstructions', 'CreateWalletsResponseDataAttributesStatus', 'CreateWalletsResponseDataAttributesWalletType', 'CreateWalletsResponseDataRelationships', 'CreateWalletsResponseDataRelationshipsParty', 'CreateWalletsResponseDataRelationshipsPartyData', 'CreateWalletsResponseDataRelationshipsPartyDataType', 'CreateWalletsResponseDataType', 'DetachAgentWalletsResponse', 'DetachAgentWalletsResponseData', 'DetachAgentWalletsResponseDataType', 'DetachAgentWalletsResponseMeta', 'FreezeWalletsResponse', 'FreezeWalletsResponseData', 'FreezeWalletsResponseDataAttributes', 'FreezeWalletsResponseDataAttributesBalance', 'FreezeWalletsResponseDataAttributesBalanceCurrency', 'FreezeWalletsResponseDataAttributesClaims', 'FreezeWalletsResponseDataAttributesDepositInstructions', 'FreezeWalletsResponseDataAttributesStatus', 'FreezeWalletsResponseDataAttributesWalletType', 'FreezeWalletsResponseDataRelationships', 'FreezeWalletsResponseDataRelationshipsParty', 'FreezeWalletsResponseDataRelationshipsPartyData', 'FreezeWalletsResponseDataRelationshipsPartyDataType', 'FreezeWalletsResponseDataType', 'GetWalletsResponseDataAttributesBalance', 'GetWalletsResponseDataAttributesBalanceCurrency', 'GetWalletsResponseDataAttributesDepositInstructions', 'GetWalletsResponseDataAttributesWalletType', 'ListAgentsWalletsResponse', 'ListAgentsWalletsResponseDataItem', 'ListAgentsWalletsResponseDataItemAttributes', 'ListAgentsWalletsResponseDataItemAttributesLimits', 'ListAgentsWalletsResponseDataItemAttributesStatus', 'ListAgentsWalletsResponseDataItemMeta', 'ListAgentsWalletsResponseDataItemMetaWalletAccess', 'ListAgentsWalletsResponseDataItemMetaWalletAccessAccessType', 'ListAgentsWalletsResponseDataItemRelationships', 'ListAgentsWalletsResponseDataItemRelationshipsParty', 'ListAgentsWalletsResponseDataItemRelationshipsPartyData', 'ListAgentsWalletsResponseDataItemRelationshipsPartyDataType', 'ListAgentsWalletsResponseDataItemType', 'ListAgentsWalletsResponseMeta', 'ListAgentsWalletsResponseMetaPagination', 'ListWalletsResponseDataItem', 'ListWalletsResponseDataItemAttributesBalance', 'ListWalletsResponseDataItemAttributesBalanceCurrency', 'ListWalletsResponseDataItemAttributesDepositInstructions', 'ListWalletsResponseDataItemAttributesWalletType', 'SetAgentDefaultWalletWalletsResponse', 'SetAgentDefaultWalletWalletsResponseData', 'SetAgentDefaultWalletWalletsResponseDataAttributes', 'SetAgentDefaultWalletWalletsResponseDataAttributesLimits', 'SetAgentDefaultWalletWalletsResponseDataAttributesStatus', 'SetAgentDefaultWalletWalletsResponseDataMeta', 'SetAgentDefaultWalletWalletsResponseDataMetaWalletAccess', 'SetAgentDefaultWalletWalletsResponseDataMetaWalletAccessAccessType', 'SetAgentDefaultWalletWalletsResponseDataRelationships', 'SetAgentDefaultWalletWalletsResponseDataRelationshipsParty', 'SetAgentDefaultWalletWalletsResponseDataRelationshipsPartyData', 'SetAgentDefaultWalletWalletsResponseDataRelationshipsPartyDataType', 'SetAgentDefaultWalletWalletsResponseDataType', 'SetDefaultWalletsResponse', 'SetDefaultWalletsResponseData', 'SetDefaultWalletsResponseDataAttributes', 'SetDefaultWalletsResponseDataAttributesBalance', 'SetDefaultWalletsResponseDataAttributesBalanceCurrency', 'SetDefaultWalletsResponseDataAttributesClaims', 'SetDefaultWalletsResponseDataAttributesDepositInstructions', 'SetDefaultWalletsResponseDataAttributesStatus', 'SetDefaultWalletsResponseDataAttributesWalletType', 'SetDefaultWalletsResponseDataRelationships', 'SetDefaultWalletsResponseDataRelationshipsParty', 'SetDefaultWalletsResponseDataRelationshipsPartyData', 'SetDefaultWalletsResponseDataRelationshipsPartyDataType', 'SetDefaultWalletsResponseDataType', 'UnfreezeWalletsResponse', 'UnfreezeWalletsResponseData', 'UnfreezeWalletsResponseDataAttributes', 'UnfreezeWalletsResponseDataAttributesBalance', 'UnfreezeWalletsResponseDataAttributesBalanceCurrency', 'UnfreezeWalletsResponseDataAttributesClaims', 'UnfreezeWalletsResponseDataAttributesDepositInstructions', 'UnfreezeWalletsResponseDataAttributesStatus', 'UnfreezeWalletsResponseDataAttributesWalletType', 'UnfreezeWalletsResponseDataRelationships', 'UnfreezeWalletsResponseDataRelationshipsParty', 'UnfreezeWalletsResponseDataRelationshipsPartyData', 'UnfreezeWalletsResponseDataRelationshipsPartyDataType', 'UnfreezeWalletsResponseDataType', 'UpdateWalletsResponse', 'UpdateWalletsResponseData', 'UpdateWalletsResponseDataAttributes', 'UpdateWalletsResponseDataAttributesBalance', 'UpdateWalletsResponseDataAttributesBalanceCurrency', 'UpdateWalletsResponseDataAttributesClaims', 'UpdateWalletsResponseDataAttributesDepositInstructions', 'UpdateWalletsResponseDataAttributesStatus', 'UpdateWalletsResponseDataAttributesWalletType', 'UpdateWalletsResponseDataRelationships', 'UpdateWalletsResponseDataRelationshipsParty', 'UpdateWalletsResponseDataRelationshipsPartyData', 'UpdateWalletsResponseDataRelationshipsPartyDataType', 'UpdateWalletsResponseDataType', 'Wallet', 'WalletAttrs', 'WalletClaims', 'WalletDetail', 'WalletDetailAttrs', 'WalletDetailClaims', 'WalletDetailData', 'WalletDetailKind', 'WalletDetailPartyRef', 'WalletDetailPartyRefKind', 'WalletDetailPartyRel', 'WalletDetailRels', 'WalletDetailStatus', 'WalletKind', 'WalletMeta', 'WalletPaging', 'WalletPartyRef', 'WalletPartyRefKind', 'WalletPartyRel', 'WalletRels', 'WalletStatus']\nannotation=List[ListWalletsResponseDataItem] required=True\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-91746e7b8b36a7bc",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 95,
  "ts": "2026-11-03T17:17:19.833Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; python3 -c \"\nfrom naturalpay.wallets.types import ListWalletsResponseDataItem as I, ListWalletsResponseDataItemAttributes as A, ListWalletsResponseDataItemAttributesBalance as B\nprint('item',list(I.model_fields)); print('attrs',list(A.model_fields)); print('bal',list(B.model_fields))\nfrom naturalpay.customers.types.list_customers_response_data_item import ListCustomersResponseDataItem as C\nprint('cust',list(C.model_fields))\n\" 2>&1 | grep -v Deprecat"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a05313853c727bf6",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 96,
  "ts": "2026-11-03T17:17:21.100Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "Traceback (most recent call last):\n  File \"<string>\", line 2, in <module>\nImportError: cannot import name 'ListWalletsResponseDataItemAttributes' from 'naturalpay.wallets.types' (/opt/freestyle/python/lib/python3.12/site-packages/naturalpay/wallets/types/__init__.py). Did you mean: 'ListAgentsWalletsResponseDataItemAttributes'?\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-a05313853c727bf6",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 103,
  "ts": "2026-11-03T17:17:27.239Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; timeout 20 curl -sSL --compressed https://docs.natural.com/api-reference/sandbox/fixtures.md | sed -n '10,70p'"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-adcdb3f48c68f8d0",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 104,
  "ts": "2026-11-03T17:17:28.061Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.\n> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.\n\n# Payment fixtures\n\n> Reserved test identifiers and synthetic counterparties for your sandbox organization\n\nPayment fixtures are synthetic counterparties visible only to your sandbox organization. They stand in for the recipient of your payment, the payer of your request, and the customer who authorizes your agents. For card numbers and card payment outcomes, see [Card fixtures](https://docs.natural.com/api-reference/sandbox/card-fixtures.md).\n\n## Send a payment\n\nPay any of these identifiers and your recipient fixture receives it:\n\n| Fixture | Email | Phone | Handle |\n| - | - | - | - |\n| Payment recipient | `payment-recipient@sandbox.natural.test` | `+14155550101` | `@sandbox.payment_recipient` |\n\n## Request a payment\n\nAddress a payment request to the payer fixture, then [fulfill](https://docs.natural.com/api-reference/simulations/fulfill-payment-request.md) or [decline](https://docs.natural.com/api-reference/simulations/decline-payment-request.md) it as the payer. The payer is always funded.\n\n| Fixture | Email | Phone | Handle |\n| - | - | - | - |\n| Funded payer | `payment-request-payer@sandbox.natural.test` | `+14155550102` | `@sandbox.request_payer` |\n\n## Pay someone who is not on Natural\n\nPayments to these identifiers wait as claims, just as they would for a real person without a Natural account. [Complete the claim](https://docs.natural.com/api-reference/simulations/complete-payment-claim.md), or call `simulate_payment_claim_completion` through MCP, to simulate the payee joining and receiving the funds.\n\n| Fixture | Email | Phone |\n| - | - | - |\n| Claim recipient | `payment-claim@sandbox.natural.test` | `+14155550103` |\n\n## Simulate Connect\n\n[Connect](https://docs.natural.com/guides/flows/build-platform.md) is how customers authorize your agents to act for them. [Invite a test customer](https://docs.natural.com/api-reference/simulations/create-test-customer.md) by choosing its agents. Natural creates the synthetic customer, visible only to your organization, and leaves one invitation `PENDING` for each agent; no customer contact details are required.\n\n[Accept](https://docs.natural.com/api-reference/simulations/accept-customer-invitation.md) or [decline](https://docs.natural.com/api-reference/simulations/decline-customer-invitation.md) each returned invitation as the test customer. After acceptance, [fund the customer](https://docs.natural.com/api-reference/simulations/fund-test-customer.md), pay on its behalf with `customerPartyId`, and [revoke an agent](https://docs.natural.com/api-reference/simulations/revoke-agent-connection.md) to test per-agent revocation, or [disconnect the customer](https://docs.natural.com/api-reference/simulations/disconnect-customer.md) when a test needs a clean slate. Revoking agents alone leaves the connection active.\n\n\nThis documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-adcdb3f48c68f8d0",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 111,
  "ts": "2026-11-03T17:17:38.324Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /sandbox/repo && printf 'naturalpay>=1.6.54\\n' > requirements.txt && python3 natural_demo/wallet_check.py; echo \"exit=$?\"; python3 natural_demo/sandbox_payment.py --help | head -12"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-8e7cebe7912908eb",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 112,
  "ts": "2026-11-03T17:17:39.419Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "NATURAL_API_KEY is not set. Get a sandbox key from the dashboard:\n  natural.com/login -> account menu (bottom-left) -> Sandbox toggle.\nexit=1\nusage: sandbox_payment.py [-h] [--amount AMOUNT] [--fund FUND] [--reuse]\n\nEnd-to-end Natural Sandbox example: connect a test customer, fund it, pay.\nEverything happens in the sandbox (https://api.sandbox.natural.com) against\nNatural's synthetic fixtures, so no real money moves. Sandbox money settles\nimmediately. export NATURAL_API_KEY=ak_ntl_sandbox_... # agent key preferred\npython natural_demo/sandbox_payment.py # new test customer python\nnatural_demo/sandbox_payment.py --reuse # reuse an active one python\nnatural_demo/sandbox_payment.py --amount 2500 # $25.00 Steps: 1. list agents\n-> pick the agent to authorize 2. simulations.invite_customer -> synthetic\ncustomer + pending invitation 3. simulations.accept_customer_invitation ->\ncustomer becomes verified 4. simulations.fund_customer -> give it a balance 5.\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-8e7cebe7912908eb",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 115,
  "ts": "2026-11-03T17:17:41.148Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /sandbox/repo && NATURAL_API_KEY=sk_ntl_sandbox_dummy_probe timeout 40 python3 natural_demo/wallet_check.py; echo \"exit=$?\""
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-97dcc19f584e254a",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 116,
  "ts": "2026-11-03T17:17:42.864Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "Natural API rejected the request: HTTP 401\n{'errors': [{'code': 'unauthenticated', 'detail': 'Authentication is required.', 'status': '401', 'meta': {'supportId': 'req_04b38f6cd98c'}}]}\nexit=1\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-97dcc19f584e254a",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 119,
  "ts": "2026-11-03T17:17:46.151Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; python3 - <<'EOF'\nimport re,html\ns=open('pricing.html',encoding='utf-8',errors='replace').read()\n# strip scripts/styles\ns=re.sub(r'<(script|style)[^>]*>.*?</\\1>','',s,flags=re.S)\ntxt=re.sub(r'<[^>]+>','\\n',s)\nlines=[html.unescape(l.strip()) for l in txt.split('\\n') if l.strip()]\ni=[n for n,l in enumerate(lines) if l=='Transfer'][0]\nprint(' | '.join(lines[i-2:i+40]))\nEOF"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b62a04cf3befc24d",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 120,
  "ts": "2026-11-03T17:17:46.151Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "Pay | Request | Transfer | Direct | Cards & credit | Accept | Cards | Credit | Developer & billing | Connect | Voice | Bill | Charge | Accounts | Start now | Consumer | Business | Enterprise | Wallets | FDIC-insured¹ wallets for agents | Consumer | Free | Business | Free | Enterprise | Free | Vault | One-way accounts for agents to move money in, never out | Consumer | Free | Business | Free | Enterprise | Free | Move money | Start now | Consumer | Business | Enterprise | Pay | Send money to an agent, business, or consumer | Consumer\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b62a04cf3befc24d",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 123,
  "ts": "2026-11-03T17:17:48.861Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /tmp; python3 - <<'EOF'\nimport re,html\ns=open('pricing.html',encoding='utf-8',errors='replace').read()\ns=re.sub(r'<(script|style)[^>]*>.*?</\\1>','',s,flags=re.S)\nlines=[html.unescape(l.strip()) for l in re.sub(r'<[^>]+>','\\n',s).split('\\n') if l.strip()]\nidx=[n for n,l in enumerate(lines) if l=='Transfer']\ni=idx[-1]\nprint(' | '.join(lines[i:i+24]))\nprint('---- Accept ----')\nj=[n for n,l in enumerate(lines) if l=='Accept'][-1]\nprint(' | '.join(lines[j:j+26]))\nEOF"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b081849d5c44cb19",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 124,
  "ts": "2026-11-03T17:17:48.861Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "Transfer | Direct | Accept | Cards | Credit | Voice | Connect | Bill | Charge | Features | Identity | Observability | Disputes | Compliance | Developers | Guides | Documentation | API Status | Join Slack | Company | About | Careers | Blog | Pricing\n---- Accept ----\nAccept | Cards | Credit | Voice | Connect | Bill | Charge | Features | Identity | Observability | Disputes | Compliance | Developers | Guides | Documentation | API Status | Join Slack | Company | About | Careers | Blog | Pricing | Contact | Connect | X | LinkedIn\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-b081849d5c44cb19",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 131,
  "ts": "2026-11-03T17:18:01.519Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /sandbox/repo && python3 -m py_compile natural_demo/*.py && echo compile-ok && NATURAL_API_KEY=ak_ntl_sandbox_dummy timeout 40 python3 natural_demo/sandbox_payment.py; echo \"exit=$?\"; ls -R --ignore=__pycache__ ."
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-9ab043215a692f45",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 132,
  "ts": "2026-11-03T17:18:03.300Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "compile-ok\nNatural API rejected a request: HTTP 401\n{'errors': [{'code': 'unauthenticated', 'detail': 'Authentication is required.', 'status': '401', 'meta': {'supportId': 'req_ed1a1bd307a1'}}]}\nexit=1\n.:\nREADME.md\nnatural_demo\nrequirements.txt\n\n./natural_demo:\nsandbox_payment.py\nwallet_check.py\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-9ab043215a692f45",
  "is_error": false,
  "tool_kind": "shell"
}

{
  "type": "tool_call",
  "seq": 135,
  "ts": "2026-11-03T17:18:05.104Z",
  "name": "bash",
  "turn": 1,
  "input": {
    "command": "cd /sandbox/repo && rm -rf natural_demo/__pycache__ && git status --short"
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-93efc0e69a79e23f",
  "tool_kind": "shell"
}

{
  "type": "tool_result",
  "seq": 136,
  "ts": "2026-11-03T17:18:05.104Z",
  "turn": 1,
  "output": {
    "content": [
      {
        "text": "?? README.md\n?? natural_demo/\n?? requirements.txt\n",
        "type": "text"
      }
    ]
  },
  "run_id": "cmw0y7uns03xq0hvbaawmeomj",
  "tool_id": "chatcmpl-tool-93efc0e69a79e23f",
  "is_error": false,
  "tool_kind": "shell"
}