neutronpay

Neutronpay MCP and SDK workflows for Lightning, stablecoin, and fiat payments.

390 stars

Best use case

neutronpay is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

Neutronpay MCP and SDK workflows for Lightning, stablecoin, and fiat payments.

Teams using neutronpay should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/neutronpay/SKILL.md --create-dirs "https://raw.githubusercontent.com/OpenAgentsInc/openagents/main/skills/neutronpay/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/neutronpay/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How neutronpay Compares

Feature / AgentneutronpayStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Neutronpay MCP and SDK workflows for Lightning, stablecoin, and fiat payments.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Neutronpay

## Overview

Integrate Neutronpay for agent-driven payments. Use this skill when tasks involve wiring the Neutron MCP server into AI tools (Cursor/Claude/Windsurf), building Neutron SDK backends, running Neutron AI-agent templates, or adding Lightning checkout flows in React apps.

## Environment

- Requires `bash`, `curl`, Node.js, and `npx`.
- Requires Neutron credentials from `portal.neutron.me`.
- Requires internet access to Neutron services and npm.

Use this skill for implementation and operations, not generic payments theory.

## Workflow

1. Pick the integration path first:
- MCP-first AI tool integration (`neutron-mcp`) for assistants using tool calls.
- SDK backend integration (`neutron-sdk`) for invoices/payments/status APIs.
- Agent runtime template (`neutron-ai-agent`) for pay-per-task automation.
- Frontend checkout (`neutron-react-payment-component`) backed by SDK endpoints.

2. Run preflight checks:
- `scripts/check-neutron-prereqs.sh mcp` for MCP configuration work.
- `scripts/check-neutron-prereqs.sh sdk` for backend SDK work.
- `scripts/check-neutron-prereqs.sh agent` for `neutron-ai-agent` flows.

3. Configure MCP from [mcp-sdk-agent-integration](references/mcp-sdk-agent-integration.md):
- Add MCP server config to tool-specific settings.
- Inject `NEUTRON_API_KEY` and `NEUTRON_API_SECRET` via environment.
- Restart/reload MCP and verify tool calls.

4. Implement Neutron API path:
- For MCP usage: validate balance lookup and invoice creation end-to-end.
- For SDK usage: wire `lightning.createInvoice`, transaction status checks, and webhook handling.
- For agent usage: wire webhook secret validation and payment-to-task completion flow.

5. Apply safety and policy controls:
- Never commit live API keys/secrets.
- Use per-environment credentials and explicit spend/risk limits.
- Require human confirmation for high-value sends.

## Quick Commands

```bash
# MCP preflight
scripts/check-neutron-prereqs.sh mcp

# Run Neutron MCP server
npx -y neutron-mcp

# SDK install in a repo
npm install neutron-sdk
```

## Reference Files

- [mcp-sdk-agent-integration](references/mcp-sdk-agent-integration.md): MCP setup, SDK entrypoints, agent template, and checkout wiring.

Related Skills

moneydevkit

390
from OpenAgentsInc/openagents

Money Dev Kit workflows for Lightning checkout and agent wallets.

mezo

390
from OpenAgentsInc/openagents

Mezo integration workflows for apps, autonomous agents, and Mezo Earn operations.

maestro

390
from OpenAgentsInc/openagents

Maestro Symphony blockchain query operations for OpenAgents agents, including tip freshness checks, address/UTXO/runes queries, and production-safe troubleshooting against deployed Symphony API endpoints.

l402

390
from OpenAgentsInc/openagents

L402 agent commerce workflows with lnd, lnget, scoped macaroons, aperture, and MCP.

charms

390
from OpenAgentsInc/openagents

Charms workflows for Bitcoin app contracts, spell proving, and UTXO asset operations.

cast

390
from OpenAgentsInc/openagents

Charms CAST DEX workflows for order creation, cancellation/replacement, partial fulfillment, signing, and Bitcoin transaction verification.

blink

390
from OpenAgentsInc/openagents

Bitcoin Lightning wallet for agents — balances, invoices, payments, BTC/USD swaps, QR codes, price conversion, and transaction history via the Blink API. All output is JSON.

autopilot-pane-control

390
from OpenAgentsInc/openagents

OpenAgents desktop pane and CAD control for Codex via openagents.* tool calls.

autopilot-data-seller

390
from OpenAgentsInc/openagents

Conversational seller-authoring policy for DS-first Data Market listings in OpenAgents.

autopilot-data-seller-cli

390
from OpenAgentsInc/openagents

Shell-first OpenAgents DS-first Data Market packaging and publication workflow using the deterministic packaging helper, autopilotctl, and the no-window headless runtime.

autopilot-data-market-control

390
from OpenAgentsInc/openagents

Typed OpenAgents DS-first Data Market tool contract for seller publication and market read-back.

autopilot-cad-builder

390
from OpenAgentsInc/openagents

Deterministic CAD build orchestration for Autopilot Chat using openagents CAD and pane tools, including week-1 gripper flow.