@naturalpay/sdk
v0.1.4
Published
Natural Payments SDK - AI agent payment infrastructure
Downloads
44
Readme
Natural Payments SDK
The Natural Payments SDK provides access to the Natural API from server-side TypeScript and JavaScript applications, for building AI agents that send, receive, and manage money.
Documentation
Full documentation, guides, and API reference are available at docs.natural.co/guides/platform/sdks.
Installation
npm install @naturalpay/sdkGetting started
import { NaturalClient } from '@naturalpay/sdk';
const client = new NaturalClient({ apiKey: process.env['NATURAL_API_KEY'] });
const payment = await client.payments.create({
recipient: '[email protected]',
amount: 5000,
memo: 'Payment for consulting',
agentId: 'agt_019cd1798d637a4da75dce386343931d',
instanceId: 'session-abc123',
customerPartyId: 'pty_019cd34e27c179bfbbe6870486b11b67',
idempotencyKey: 'pay_unique_key',
});
console.log(payment.transactionId);MCP server
The SDK ships with an MCP server for AI agent integration with Claude Desktop, Cursor, and other MCP clients:
npx @naturalpay/sdk mcp serveSee docs.natural.co/guides/platform/sdks#mcp-server for client configuration.
Requirements
Node.js 18+
License
MIT
