⚡ invinoveritas

Lightning-paid reasoning and decision intelligence for autonomous agents

Pay-per-insight API using the L402 protocol (Bitcoin Lightning).
No subscriptions. No accounts. No KYC.

Live API: https://invinoveritas.onrender.com
MCP Endpoint: https://invinoveritas.onrender.com/mcp
MCP Registry: io.github.babyblueviper1/invinoveritas

Quick Start

Python SDK — manual payment flow

pip install invinoveritas

from invinoveritas import InvinoClient, PaymentRequired

client = InvinoClient()

try:
    result = client.reason("What are the biggest risks for Bitcoin in 2026?")
except PaymentRequired as e:
    print(f"Pay: {e.invoice}  ({e.amount_sats} sats)")
    result = client.reason(
        "What are the biggest risks for Bitcoin in 2026?",
        payment_hash=e.payment_hash,
        preimage="your_preimage_here",
    )
    print(result.answer)

Python SDK — autonomous payments (v0.3.1)

Agents pay automatically. No human in the loop.

# LND node
pip install "invinoveritas[langchain]"

# Alby, Zeus, or any NWC wallet (no node required)
pip install "invinoveritas[nwc]"

# With LND
from invinoveritas.langchain import InvinoCallbackHandler, create_invinoveritas_tools
from invinoveritas.providers import LNDProvider

handler = InvinoCallbackHandler(
    provider=LNDProvider(
        macaroon_path="/root/.lnd/data/chain/bitcoin/mainnet/admin.macaroon",
        cert_path="/root/.lnd/tls.cert"
    )
)

# With NWC (Alby, Zeus, Mutiny — no node required)
from invinoveritas.providers import NWCProvider

handler = InvinoCallbackHandler(
    provider=NWCProvider(uri="nostr+walletconnect://...")
)

tools = create_invinoveritas_tools(handler)
result = agent.run("Should I increase my BTC exposure in 2026?", callbacks=[handler])
print(f"Spent: {handler.total_spent_sats} sats")

Full SDK docs → sdk/README.md

Agent Wallets

Agents can pay automatically using Lightning. There are two main options:

• LND Node — Full control, runs your own Lightning node

• NWC Wallet (Alby, Zeus, Mutiny) — No node required, easiest setup

All payments are cryptographically verifiable and atomic.

Minimal SDK Example (NWC Wallet)

from invinoveritas.providers import NWCProvider
from invinoveritas.langchain import InvinoCallbackHandler, create_invinoveritas_tools

handler = InvinoCallbackHandler(
    provider=NWCProvider(uri="nostr+walletconnect://YOUR_WALLET_URI_HERE")
)

tools = create_invinoveritas_tools(handler)

result = agent.run(
    "Should I increase my BTC exposure in 2026?", 
    callbacks=[handler]
)

print(f"Spent: {handler.total_spent_sats} sats")
print(result)

Replace YOUR_WALLET_URI_HERE with your WalletConnect URI from Alby, Zeus, or Mutiny.

For LND Node Users

Simply swap the provider:

from invinoveritas.providers import LNDProvider
from invinoveritas.langchain import InvinoCallbackHandler, create_invinoveritas_tools

handler = InvinoCallbackHandler(
    provider=LNDProvider(
        macaroon_path="/root/.lnd/data/chain/bitcoin/mainnet/admin.macaroon",
        cert_path="/root/.lnd/tls.cert"
    )
)

tools = create_invinoveritas_tools(handler)

Official Wallet Setup Guides

• LND Node: https://docs.lightning.engineering

• WalletConnect / NWC Wallets: https://walletconnect.com/

MCP Endpoint (Claude Desktop, Cursor)

Point your MCP-compatible agent to:

https://invinoveritas.onrender.com/mcp

Full L402 payment handling built-in. Supports initialize, tools/list, and callTool.

lnget (CLI agents)

lnget handles L402 automatically:

lnget POST https://invinoveritas.onrender.com/reason \
  '{"question": "What are the biggest risks for Bitcoin in 2026?"}'

Direct HTTP

curl -X POST https://invinoveritas.onrender.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "callTool",
    "params": {
      "name": "reason",
      "arguments": { "question": "What are the biggest risks for Bitcoin in 2026?" }
    }
  }'

After paying the returned invoice, retry with: -H "Authorization: L402 <payment_hash>:<preimage>"

Pricing (Dynamic)

Prices can vary slightly based on input length.
Full pricing → /prices

Credit-Based Accounts (Optional)

For users or agents who prefer pre-funded accounts instead of paying per call:

• Register an Account
  POST /accounts/register → Returns a 1000 sats invoice

• Top Up
  POST /accounts/topup → Provide api_key and amount

• Settle Top-Up
  POST /accounts/settle-topup → Confirm with preimage

• Use Credits
  Include your api_key in requests — balance is debited automatically

• Check Balance
  GET /accounts/balance?api_key=<your_api_key>

Benefits: No invoice per call, ideal for high-frequency usage.

Why Agents Use invinoveritas

Autonomous agents use invinoveritas when they need:

• Strategic reasoning deeper than local models

• Structured, machine-readable decisions with confidence & risk scores

• Deterministic, predictable costs (paid in sats)

• Cryptographically verifiable payments via Lightning

• Native MCP tool support

Pay only when the insight truly matters — atomically, with Bitcoin Lightning.

Core Tools

• reason — Premium strategic reasoning

• decide — Structured decision intelligence with confidence and risk scores

Both tools support the full L402 payment flow via REST, MCP, or SDK.

Payment Flow (L402)

1. First call → returns 402 Payment Required + Lightning invoice

2. Pay the invoice using any Lightning wallet or lnget

3. Retry with: Authorization: L402 <payment_hash>:<preimage>

4. Receive the result

Full guide → /guide

Discovery Endpoints (Free)

• GET /health — Service status and pricing

• GET /prices — All tool prices in one call

• GET /guide — Step-by-step payment guide

• GET /.well-known/mcp/server-card.json — MCP server card

• GET /price/{endpoint} — Current price in sats

Philosophy

Most AI agents are stuck with subscriptions or unpredictable token costs.

invinoveritas offers a better model:

Atomic intelligence purchases using Bitcoin Lightning.

Pay only when the decision matters — with sats, instantly, and without intermediaries.

Built for the Bitcoin × AI future. ⚡

Quick Links

• GitHub: https://github.com/babyblueviper1/invinoveritas

• Live API: https://invinoveritas.onrender.com

• MCP Endpoint: https://invinoveritas.onrender.com/mcp

• MCP Registry: https://registry.modelcontextprotocol.io

• PyPI: https://pypi.org/project/invinoveritas/

• Health Check: https://invinoveritas.onrender.com/health

• Payment Guide: https://invinoveritas.onrender.com/guide