Metadata-Version: 2.4
Name: naturalpay
Version: 0.0.8
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: Documentation, https://docs.natural.co
Project-URL: Homepage, https://natural.co
Project-URL: Repository, https://github.com/naturalpay/naturalpay-python
Provides-Extra: dev
Description-Content-Type: text/markdown

# naturalpay

Natural Payments SDK

## Installation

```bash
pip install naturalpay
# or
uv add naturalpay
```

## Quick Start

```python
from naturalpay import NaturalClient

client = NaturalClient(api_key="pk_sandbox_xxx")

# Create a payment
payment = await client.payments.create(
    recipient_email="alice@example.com",
    amount=50.00,
    memo="For consulting"
)

print(payment.transfer_id)  # txn_abc123
```

## MCP Server

Run the MCP server for AI agent integrations:

```bash
# Using uvx (recommended)
uvx naturalpay mcp serve

# Or using python module
python -m naturalpay mcp serve

# With SSE transport
uvx naturalpay mcp serve --transport sse --port 8080
```

> **Note:** We recommend `uvx` or `python -m` over global installation to avoid conflicts if you also use the TypeScript SDK (`npx @naturalpay/sdk`).

## Documentation

- [API Reference](https://docs.natural.co)
- [Examples](https://github.com/naturalpay/natural-examples)

## License

MIT
