ampersend-sdk

mcp
Guvenlik Denetimi
Gecti
Health Gecti
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 23 GitHub stars
Code Gecti
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This SDK provides tooling for building applications that use the x402 payment protocol. It supports both buyer and seller roles, enabling AI agents and LLM applications to handle pay-per-request transactions via A2A, MCP, and HTTP transports.

Security Assessment
The overall risk is rated as Low. Because this is a financial SDK designed to handle cryptocurrency payments, it inherently deals with sensitive data. It requires an Ethereum wallet private key to sign payments, which must be securely managed via the `.env` file and never committed to version control. The code makes network requests by design to verify and route payments, but the automated code scan found no dangerous patterns, hardcoded secrets, or hidden shell execution exploits.

Quality Assessment
The project demonstrates strong maintenance health, with repository activity reported as recent as today. It uses the standard, permissive Apache-2.0 license, making it suitable for most development projects. While the repository is relatively new and has a modest community footprint (23 GitHub stars), the codebase is clean, well-documented, and organized following standard package structures for both Python and TypeScript.

Verdict
Safe to use, provided you follow standard security practices for managing your private keys and wallet credentials.
SUMMARY

Tooling for building applications with x402 payment capabilities. Supports buyer and seller roles.

README.md

Ampersend SDK

Multi-language SDK for building applications with x402 payment capabilities.
Supports both buyer (client) and seller (server) roles with flexible payment verification and authorization patterns.

Looking for examples? See the ampersend-examples repository.

📦 Language Support

🚀 Quick Start

Python

# Install Python 3.13
uv python install 3.13

# Install dependencies
uv sync --frozen --all-packages --group dev

Full Python documentation

TypeScript

# Install dependencies
pnpm install
pnpm build

# Configure environment
cp .env.example .env
# Edit .env with your credentials

# Run MCP proxy server
pnpm --filter ampersend-sdk proxy:dev

# Or run FastMCP example server
pnpm --filter fastmcp-x402-server dev

Full TypeScript documentation

📚 Documentation

Core Concepts

x402 Protocol - Transport-agnostic payment protocol for agent and LLM applications that enables pay-per-request
patterns. See x402 specification.

Supported Transports:

  • A2A (Agent-to-Agent) - Transport protocol for agent communication with payment capabilities
  • MCP (Model Context Protocol) - Transport protocol for LLM-tool integration with payment capabilities
  • HTTP - Standard HTTP client with x402 payment capabilities (TypeScript)

Key Components:

  • Treasurer - Authorizes and tracks payments
  • Wallet - Creates and signs payment proofs (EOA and Smart Account support)
  • Client - Initiates requests with payment handling
  • Server - Verifies payments and processes requests

Repository Structure

ampersend-sdk/
├── python/
│   ├── ampersend-sdk/           # Python SDK package
│   └── langchain-ampersend/     # LangChain integration
└── typescript/
    └── packages/
        └── ampersend-sdk/       # TypeScript SDK package

🔧 Prerequisites

Python

  • uv - Dependency management (install)
  • Python 3.13+

TypeScript

  • Node.js 18+
  • pnpm - Package manager

Development

  • Test USDC - For payment testing (Circle faucet)
  • Private Key - Ethereum wallet for signing payments

📄 License

Apache 2.0 - See LICENSE

Yorumlar (0)

Sonuc bulunamadi