Metadata-Version: 2.4
Name: naturalpay
Version: 0.1.4
Summary: Natural Payments SDK
Keywords: payments,ai,agents,mcp,llm
Author: Natural
Author-email: Natural <walt@natural.co>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: fastmcp>=2,<3
Requires-Dist: httpx>=0.28.1
Requires-Dist: pydantic>=2.12.5
Requires-Dist: pytest>=8.0 ; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24 ; extra == 'dev'
Requires-Dist: pytest-cov>=4.0 ; extra == 'dev'
Requires-Dist: ruff>=0.8.0 ; extra == 'dev'
Requires-Dist: mypy>=1.13.0 ; extra == 'dev'
Requires-Dist: twine>=5.0 ; extra == 'dev'
Requires-Dist: pre-commit>=4.0 ; extra == 'dev'
Requires-Python: >=3.12
Project-URL: Homepage, https://natural.co
Project-URL: Documentation, https://docs.natural.co
Project-URL: Repository, https://github.com/naturalpay/naturalpay-python
Provides-Extra: dev
Description-Content-Type: text/markdown

# Natural Payments Python SDK

[![PyPI version](https://img.shields.io/pypi/v/naturalpay.svg)](https://pypi.org/project/naturalpay/)

The Natural Payments SDK for Python provides access to the [Natural API](https://docs.natural.co) for building AI agents that send, receive, and manage money.

## Documentation

Full documentation, guides, and API reference are available at **[docs.natural.co/guides/platform/sdks](https://docs.natural.co/guides/platform/sdks)**.

## Installation

```sh
pip install naturalpay
```

## Getting started

```python
import os

from naturalpay import NaturalClientSync

client = NaturalClientSync(api_key=os.environ.get("NATURAL_API_KEY"))

payment = client.payments.create(
    recipient="alice@example.com",
    amount=5000,
    memo="Payment for consulting",
    agent_id="agt_019cd1798d637a4da75dce386343931d",
    instance_id="session-abc123",
    customer_party_id="pty_019cd34e27c179bfbbe6870486b11b67",
    idempotency_key="pay_unique_key",
)

print(payment.transaction_id)
```

An async client is also available as `NaturalClient`. See [docs.natural.co/guides/platform/sdks](https://docs.natural.co/guides/platform/sdks#async-and-sync-python) for the async pattern.

## MCP server

The SDK ships with an MCP server for AI agent integration with Claude Desktop, Cursor, and other MCP clients:

```sh
uvx naturalpay mcp serve
```

See [docs.natural.co/guides/platform/sdks#mcp-server](https://docs.natural.co/guides/platform/sdks#mcp-server) for client configuration.

## Requirements

Python 3.12+

## License

MIT
