Metadata-Version: 2.5
Name: envarpay
Version: 0.1.0a6
Summary: Get your agents paid. MCP and x402 payment SDK and CLI for agents.
Project-URL: Homepage, https://github.com/EnvarAI/EnvarPay
Project-URL: Repository, https://github.com/EnvarAI/EnvarPay
Project-URL: Issues, https://github.com/EnvarAI/EnvarPay/issues
Project-URL: Documentation, https://github.com/EnvarAI/EnvarPay/tree/main/docs
Author: EnvarAI contributors
License-Expression: MIT
License-File: LICENSE
Keywords: agents,hermes,mcp,payments,usdc,x402
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: httpx<1,>=0.28
Requires-Dist: jsonschema<5,>=4.20
Requires-Dist: loguru<1,>=0.7
Requires-Dist: mcp==1.28.1
Requires-Dist: pydantic<3,>=2.11
Requires-Dist: starlette<2,>=1.3.1
Requires-Dist: tomli-w<2,>=1.2
Requires-Dist: uvicorn<1,>=0.31
Requires-Dist: x402[evm,mcp]==2.24.0
Provides-Extra: task
Requires-Dist: web3<8,>=7; extra == 'task'
Provides-Extra: test
Requires-Dist: build>=1.2; extra == 'test'
Requires-Dist: pytest-asyncio>=0.25; extra == 'test'
Requires-Dist: pytest>=8; extra == 'test'
Requires-Dist: respx>=0.22; extra == 'test'
Requires-Dist: ruff>=0.12; extra == 'test'
Requires-Dist: web3<8,>=7; extra == 'test'
Description-Content-Type: text/markdown

# EnvarPay

Add a budgeted payment wallet and an upfront USDC payment gate to existing agents.
EnvarPay uses the official MCP and x402 v2 SDKs. Your agent keeps its own runtime,
model and tools.

## Install

These registry commands apply after publication. For the current source preview,
see [installation channels](https://github.com/EnvarAI/EnvarPay/blob/main/docs/packages.md).

For a persistent CLI installation:

```sh
uv tool install envarpay==0.1.0a6
envarpay --help
```

For the Python API, use an isolated environment:

```sh
python -m pip install envarpay==0.1.0a6
```

Python 3.11 or newer is required. Keep the wallet environment separate from
frameworks using a different MCP major version.

## Choose a capability

- **Pay:** `envarpay wallet` exposes policy-constrained MCP tools to your agent.
- **Receive:** `envarpay serve` puts a payment gate in front of a private MCP or HTTP service.
- **Set up:** `envarpay init --agent NAME --role buyer|seller|both` generates editable configs and instructions.
- **Inspect:** `envarpay doctor`, `status` and the explicit original-operation recovery flow.

Start with the guide for your framework:

- [OpenClaw](https://github.com/EnvarAI/EnvarPay/blob/main/docs/integrations/openclaw.md)
- [Hermes](https://github.com/EnvarAI/EnvarPay/blob/main/docs/integrations/hermes.md)
- [OpenCode](https://github.com/EnvarAI/EnvarPay/blob/main/docs/integrations/opencode.md)
- [Goose](https://github.com/EnvarAI/EnvarPay/blob/main/docs/integrations/goose.md)
- [LangGraph / LangChain](https://github.com/EnvarAI/EnvarPay/blob/main/docs/integrations/langgraph.md)
- [Pydantic AI](https://github.com/EnvarAI/EnvarPay/blob/main/docs/integrations/pydantic-ai.md)

MCP connections work across languages. An agent does not need to be written in
Python to connect to this service. This distribution includes a Python SDK and
CLI; it does not claim to include a TypeScript SDK or a framework-native plugin.

## Alpha boundaries

Payments default to **off**, using Base Sepolia test USDC and explicit recipient,
tool and budget policies. Preserve the original request ID, authorization and
ledger on uncertainty. A paid request can still fail during execution; payment
does not establish output quality or an automatic refund.

The historical [testnet matrix](https://github.com/EnvarAI/EnvarPay/blob/main/docs/integrations/validation.md)
records 28 successful paid deliveries and two failed settlements across six
native frameworks. Package installation and CI are not additional payment evidence.

[Repository](https://github.com/EnvarAI/EnvarPay) ·
[Configuration](https://github.com/EnvarAI/EnvarPay/blob/main/docs/configuration.md) ·
[Python API](https://github.com/EnvarAI/EnvarPay/blob/main/docs/python-sdk.md) ·
[Security](https://github.com/EnvarAI/EnvarPay/security/advisories/new)
