Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lumina-org.com/llms.txt

Use this file to discover all available pages before exploring further.

​
What is MCP?

The Model Context Protocol is an open standard that lets AI assistants connect to external tools and data. The official Lumina MCP server (@lumina-org/mcp-server) exposes the protocol as MCP tools, resources, and prompts — so any MCP client can browse products, quote premiums, and buy a policy in one sentence.

​
Why Lumina ships an MCP server

Lumina is agent-first. One MCP server reaches every MCP-capable client at once (Claude Desktop, Cursor, Windsurf, Continue, …). The default purchase path is the sandbox — a real on-chain policy with no wallet, no gas, and no API key.
The server never holds a private key. Write actions (buy_policy_real, redeem_bond, marketplace_*) return an unsigned transaction for your wallet/agent to sign. The sandbox path needs no wallet at all.

​
Setup (Claude Desktop)

Add this to claude_desktop_config.json: 
{
  "mcpServers": {
    "lumina": {
      "command": "npx",
      "args": ["-y", "@lumina-org/mcp-server"]
    }
  }
}
Restart Claude Desktop, then ask: “Use Lumina to buy a FLASHBTC1H policy.”

​
Cursor / Windsurf / Continue

{ "mcpServers": { "lumina": { "command": "npx", "args": ["-y", "@lumina-org/mcp-server"] } } }
(Continue uses experimental.modelContextProtocolServers with a stdio transport.)

​
Optional env

VarPurpose
LUMINA_API_KEYlk_… key for wallet-scoped reads (policies/bonds)
LUMINA_API_BASE / LUMINA_CHAIN_ID / LUMINA_RPC_URLpoint at a different deployment

​
What it exposes

Tools (11): browse_products, quote_policy, buy_policy_sandbox, buy_policy_real, get_policy_status, get_bond_balance, redeem_bond, marketplace_list, marketplace_buy, watch_triggers, get_protocol_stats. Resources (4): lumina://products, lumina://stats, lumina://policies/{wallet}, lumina://bonds/{wallet}. Prompts (3): first_policy, compare_products, monitor_portfolio.

​
Use cases

  • One-sentence purchase: “Buy me flash-crash cover on BTC for the next hour.”
  • Portfolio monitoring: the monitor_portfolio prompt summarizes policies, bonds, and approaching triggers for a wallet.
  • Self-signed flows: buy_policy_real / redeem_bond return unsigned txs your agent signs with its own wallet — keys never leave the client.