# Provider

> x402 service provider tooling for Azeth — gate Hono endpoints behind x402 payments

- **Type:** MCP server
- **Install:** `agentstack add mcp-azeth-protocol-provider`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [azeth-protocol](https://agentstack.voostack.com/s/azeth-protocol)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [azeth-protocol](https://github.com/azeth-protocol)
- **Source:** https://github.com/azeth-protocol/provider
- **Website:** https://azeth.ai

## Install

```sh
agentstack add mcp-azeth-protocol-provider
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# @azeth/provider

x402 service provider tooling for [Azeth](https://azeth.ai). Gate your Hono endpoints behind x402 payments with built-in payment-agreement support, SIWx sessions, and automatic reputation feedback.

## Installation

```bash
npm install @azeth/provider
# or
pnpm add @azeth/provider
```

## Quick Start

```typescript
import { Hono } from 'hono';
import { createX402StackFromEnv } from '@azeth/provider';

const app = new Hono();

const { middleware, facilitator } = await createX402StackFromEnv({
  app,
  routes: {
    '/api/data': { price: '$0.01', resource: 'https://api.example.com/data' },
  },
});

app.use('/api/*', middleware);

app.get('/api/data', (c) => c.json({ answer: 42 }));
```

## Features

- **x402 Payment Middleware** -- Returns 402 with payment requirements, validates on-chain USDC settlement
- **Payment Agreements** -- Recurring subscriptions via on-chain `PaymentAgreementModule`
- **SIWx Sessions** -- Agreement-aware session storage for repeat customers
- **Agreement Keeper** -- Periodic execution of due payment agreements
- **Pre-Settled Payments** -- Middleware for endpoints accepting pre-settled x402 proofs
- **Local Facilitator** -- On-chain payment verification without external facilitator dependency

## API

### Stack Setup

| Export | Description |
|---|---|
| `createX402Stack(config)` | Create x402 middleware + facilitator from explicit config |
| `createX402StackFromEnv(routes, overrides?)` | Create from env vars. Auto-resolves `payTo` to your smart account if not set. |
| `LocalFacilitatorClient` | On-chain USDC settlement verification |

### Payment Agreements

| Export | Description |
|---|---|
| `createPaymentAgreementExtension()` | x402 extension for agreement-based payments |
| `AzethSIWxStorage` | Agreement-aware SIWx session storage |
| `AgreementKeeper` | Periodic execution of due agreements |
| `findActiveAgreementForPayee()` | LRU-cached agreement lookup |

### Middleware

| Export | Description |
|---|---|
| `preSettledPaymentMiddleware` | Accept pre-settled x402 payment proofs |
| `paymentMiddlewareFromHTTPServer` | Standard x402 HTTP resource server middleware |

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [azeth-protocol](https://github.com/azeth-protocol)
- **Source:** [azeth-protocol/provider](https://github.com/azeth-protocol/provider)
- **License:** MIT
- **Homepage:** https://azeth.ai

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-azeth-protocol-provider
- Seller: https://agentstack.voostack.com/s/azeth-protocol
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.