⚡ 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

Ful

... View full README on GitHub