AiFinPay

Servidor MCP para agentes de IA autónomos: identidad persistente del agente, resolución de Agent Passport, descubrimiento de rutas, historial de pagos, cuotas y facturas de liquidación AIFP-1/AIFP-2 sin firma.

GitHub

Documentación

AiFinPay — rieles financieros para agentes de IA

AiFinPay proporciona infraestructura de pagos y monetización para agentes de IA autónomos.

Lado del agente: identidad, descubrimiento de billeteras, historial de pagos, descubrimiento de rutas, cuotas y preparación de liquidaciones.
Lado del comerciante: muros de pago HTTP 402 y monetización por solicitud para tráfico de IA.
Diseño sin custodia: las claves privadas permanecen con el agente/operador. Las herramientas públicas de MCP no exponen semillas ni claves privadas.

Dominio canónico: https://aifinpay.io

Versiones actuales de paquetes

Paquete	Versión fuente actual	Instalación
`aifinpay-agent` (Python)	`2.1.0`	`pip install aifinpay-agent`
`@aifinpay/agent` (Node / TypeScript)	`2.0.1`	`npm install @aifinpay/agent`
`@aifinpay/mcp`	`2.1.0`	`npx @aifinpay/mcp`
`@aifinpay/mcp-http`	`2.0.2`	Envoltorio Streamable HTTP
`@aifinpay/skill`	`2.0.9`	`npm install @aifinpay/skill`
`@aifinpay/gate`	`0.3.2`	`npm install @aifinpay/gate`
`@aifinpay/wallet`	`1.1.0`	`npm install @aifinpay/wallet`
`@aifinpay/deployments`	`1.1.2`	paquete de registro de despliegue

Las líneas de paquetes tienen versiones independientes. Los manifiestos de paquetes en este repositorio y los registros correspondientes de npm/PyPI son la fuente de verdad.

Instalación

# MCP
npx @aifinpay/mcp

# Node / TypeScript SDK
npm install @aifinpay/agent

# Python SDK
pip install aifinpay-agent

# Merchant paywall
npm install @aifinpay/gate

# Agent skills
npm install @aifinpay/skill

MCP: superficie de producción actual

La fuente actual de @aifinpay/mcp expone las siguientes herramientas de producción:

Herramienta	Propósito
`agent_address`	Leer las direcciones públicas actuales de EVM, Solana y Casper.
`agent_reload`	Recargar archivos de billetera local configurados sin iniciar una nueva conversación.
`agent_quota`	Leer la cuota del agente.
`agent_history`	Leer el historial de pagos indexado de AiFinPay o el historial de recibos retenidos.
`agent_passport_resolve`	Resolver una identidad pública de Agent Passport y los enlaces de billetera verificados.
`settlement_routes`	Leer las rutas de liquidación AIFP-1 / AIFP-2 verificadas en tiempo de ejecución.
`settlement_invoice`	Construir y validar una factura de liquidación EVM sin firma.
`settlement_solana`	Construir y validar una factura de liquidación Solana sin firma.
`settlement_casper`	Construir y validar una factura de liquidación Casper sin firma.
`deployment_info`	Leer direcciones de despliegue, IDs de programa y estado de liquidación en los ecosistemas compatibles.

Con AIFINPAY_MODE=dev, una herramienta adicional dev_payment_quote está disponible para inspección de cotizaciones solo en desarrollo.

La superficie pública de MCP no firma ni transmite pagos. Crear una factura o cotización no es un pago completado.

Herramientas heredadas como payable_fetch, agent_call, agent_quote, pay_with_split, quote_split y agent_claim_self no están registradas por el servidor MCP de producción actual.

Configuración del cliente MCP

{
  "mcpServers": {
    "aifinpay": {
      "command": "npx",
      "args": ["-y", "@aifinpay/mcp"]
    }
  }
}

Para una identidad local persistente, inicialice el almacén de claves una vez:

npx @aifinpay/mcp init

Luego use agent_reload y agent_address para verificar la billetera pública seleccionada. No pegue semillas ni claves privadas en chats, problemas, registros o configuración compartida.

Configuración completa del cliente: MCP_CONFIG.md

Estado de pago del SDK

Las superficies del SDK tienen diferentes estados de ejecución. No las trate como intercambiables.

Node / TypeScript

@aifinpay/agent incluye la ruta revisada AIFP-1 fetchPaid. La ejecución pagada está controlada por verificaciones en tiempo de ejecución, incluido el despliegue/perfil revisado de Polygon v1.3 y un precio fresco y confiable de nativo/USD. Una cotización, factura o hash de ejecución coincidente por sí solo no es prueba de que una ruta esté habilitada para producción.

Consulte node/README.md y node/PAYMENT_RECEIPTS.md.

Python

El paquete de Python admite identidad y funciones relacionadas del SDK, pero su ruta de liquidación pagada heredada call() está deshabilitada y actualmente no expone el ejecutor fetchPaid de Node.

Consulte python/README.md.

Economía

Economía de protocolo actual documentada en la línea v2:

AIFP-1: el pagador paga el monto bruto cotizado; el comerciante recibe 99%; AiFinPay recibe 1%; creador/referido recibe 0%.
AIFP-2 / x402: el proveedor recibe 100%; la tarifa de protocolo de AiFinPay es actualmente 0%.

Los ejemplos más antiguos de 98.99% / 1% / 0.01% pertenecen a un modelo de tarifas retirado y no deben usarse como economía actual.

Monetización para comerciantes

Para un sitio o API que quiera monetizar el tráfico de agentes de IA:

npm install @aifinpay/gate

El paquete de comerciante puede devolver desafíos HTTP 402, exponer metadatos de descubrimiento y medir el acceso pagado. Consulte gate/README.md y la habilidad aifinpay-merchant en skill/skills/aifinpay-merchant/SKILL.md.

Estado de despliegue

Las direcciones de despliegue y los IDs de programa son datos de registro; por sí solos no son prueba de que la liquidación esté habilitada. Use deployment_info o el registro de despliegue y verifique settlementEnabled / status antes de presentar una red como activa.

Solana

El programa Solana antiguo 5g9zWHF1Vv6GiGpA2ZbJQbSCDZd5hAk9AyvabRJvKFx2 fue cerrado y no es el programa actual.

El registro actual contiene los programas v1.4.1 redesplegados a continuación, ambos actualmente deshabilitados para liquidación:

Red	ID de programa	Estado de liquidación	Razón
Devnet	`8dty5bD738Z9TzEkDu8vLSnhpJNWtEGMUEcYaKCUTY6y`	Deshabilitado	La verificación de recibos del backend no está implementada.
Mainnet	`724Ut31i4ecY4dJ25z8HuZetu3A43xtNkPdk4JdbsfdD`	Deshabilitado	La verificación de recibos del backend no está implementada y la autoridad de actualización no es multisig.

Fuente canónica del registro: deployments/registry/splitter/solana/deployments.json

Evidencia histórica de mainnet

Estas son solo transacciones históricas. No certifican la versión actual, el modelo de tarifas ni la preparación de producción actual.

Proveedor	Activo	Uso histórico	Transacción
Exa Search	POL	Llamada SDK vía Exa	`0xeb13c5eddf645b3e5b5e5db82d8b19d301a4c0c8593f6e7dce9cd4c3359c8700`
io.net	POL	Inferencia Llama-3.3-70B, $0.025	`0x7c6ca0ffcf75b1ca3ade4800fb896c4bb08bc5f1a91916dc2cf4918f16129f0a`

Estructura del repositorio

sdk/
├── node/          @aifinpay/agent
├── python/        aifinpay-agent
├── mcp/           @aifinpay/mcp
├── mcp-http/      Streamable HTTP wrapper
├── skill/         @aifinpay/skill
├── gate/          merchant HTTP 402 paywall
├── wallet/        lightweight agent wallet / keystore
├── deployments/   deployment registry
└── examples/      integrations and reference examples

Reglas de seguridad

Nunca imprima, registre o publique una semilla, clave privada, JSON de almacén de claves o secreto de firma.
Las direcciones públicas y los hashes de transacción son seguros de mostrar.
No infiera preparación de producción solo a partir de una dirección de contrato, ID de programa, cotización o factura.
Conserve la cotización original, la referencia de transacción y el contexto de idempotencia al recuperarse de un error de liquidación para evitar intentos de pago duplicados accidentales.

Enlaces

Sitio web: https://aifinpay.io
Documentación: https://aifinpay.io/docs
Inicio rápido: QUICKSTART.md
Configuración de MCP: MCP_CONFIG.md
Problemas: https://github.com/AiFinPay/sdk/issues
Especificación de MCP: https://modelcontextprotocol.io
x402: https://www.x402.org

Licencia

MIT — consulte LICENSE.