oerc-s/primordia

oerc-s/primordia

от oerc-s
Kaledge — MCP-сервер для финансовых расчетов между AI-агентами. Выпускает криптографические чеки (MSR), сжимает тысячи транзакций в чистые обязательства и ведет балансы. Полезен разработчикам, чьи ...

Kaledge

The clearing layer for machine commerce.

When AI agents transact at scale, someone has to settle. That's Kaledge.

npm Kernel Docs

What is Kaledge?

Kaledge provides financial infrastructure for AI agents:

  • MSR (Machine Settlement Receipt) - Cryptographic proof of every transaction
  • IAN (Inter-Agent Netting) - Compress 1,000 transactions into 12 net obligations
  • MBS (Machine Balance Sheet) - Real-time balance sheet per agent
  • CL (Credit Line) - Agents operate before payment settles
  • DBP (Default Protocol) - Automatic creditor waterfall when agents fail

Why?

AI agents are economic actors. They consume compute, call APIs, transact with each other.

Without settlement infrastructure:

  • No receipts → disputes unresolvable
  • No netting → 1000x settlement overhead
  • No credit → agents block on payment
  • No default handling → legal disputes

Quick Start

SDK (TypeScript)
npm install @primordia1/sdk
import { createMSR, verifyMSR } from '@primordia1/sdk';

// Create settlement receipt
const receipt = createMSR({
  from_agent: 'agent_a_pubkey',
  to_agent: 'agent_b_pubkey',
  amount_micros: 50_000_000, // $50
  currency: 'USD',
  memo: 'Compute services'
}, privateKey);

// Verify receipt
const valid = verifyMSR(receipt);
Инструменты были проиндексированы:
accrue_interest

Начислить проценты по кредитной позиции (PAID - $1, SEAL REQUIRED)

Параметры
  • agent_idstringобязательный

    Agent ID (borrower or lender)

  • credit_line_idstringобязательный

    Credit line ID

  • days_accruednumberобязательный

    Number of days to accrue interest for

  • request_hashstringобязательный

    Unique request hash for idempotency

  • window_idstringобязательный

    Accrual window identifier (e.g., 'window_2024_01')

apply_fee

Применить сбор к кредитной позиции (PAID - $1, SEAL REQUIRED)

Параметры
  • agent_idstringобязательный

    Agent ID

  • amount_usd_microsnumberобязательный

    Fee amount in USD micros

  • credit_line_idstringобязательный

    Credit line ID

  • fee_typeenumобязательный

    Type of fee

  • reasonstringобязательный

    Reason for the fee

  • request_hashstringобязательный

    Unique request hash for idempotency

close_credit_line

Закрыть кредитную линию (БЕСПЛАТНО, ТРЕБУЕТСЯ ПЕЧАТЬ, баланс должен быть нулевым)

Параметры
  • agent_idstringобязательный

    Agent ID (borrower or lender)

  • credit_line_idstringобязательный

    Credit line ID to close

  • request_hashstringобязательный

    Unique request hash for idempotency

commit_future

Зафиксировать будущее обязательство (FC) в клиринговой системе (операция PAID)

Параметры
  • agent_idstringобязательный

    Agent ID making the commitment

  • fcobjectобязательный

    Future Commitment object with promise, collateral, and settlement terms

draw_credit

Снять основную сумму с кредитной линии (ОПЛАЧЕНО - 10 б.п. от суммы снятия, ТРЕБУЕТСЯ ПЕЧАТЬ)

Параметры
  • amount_usd_microsnumberобязательный

    Amount to draw in USD micros

  • borrower_agent_idstringобязательный

    Borrower agent ID

  • credit_line_idstringобязательный

    Credit line ID to draw from

  • request_hashstringобязательный

    Unique request hash for idempotency

emit_meter

Создаёт квитанцию учёта (Вычислительные ресурсы или Энергия). ЛОКАЛЬНО по умолчанию (без сети). Установите submit=true для индексации с последующим неттингом.

Параметры
  • agent_idstringобязательный

    Agent ID emitting the meter receipt

  • metadataobject

    Optional metadata (model, region, etc.)

  • providerstringобязательный

    Provider ID (e.g., 'openai', 'anthropic', 'aws')

  • submitboolean

    If true, submit to kernel /v1/index/batch for later netting. Default: false (local only)

  • typeenumобязательный

    Meter type: 'compute' (GPU/CPU tokens) or 'energy' (kWh)

  • unit_price_usd_microsnumberобязательный

    Price per unit in USD micros (1 USD = 1,000,000 micros)

  • unitsnumberобязательный

    Units consumed (tokens for compute, kWh for energy)

get_balance_sheet

Получает Machine Balance Sheet (MBS) аудиторского уровня на основе окон SIGNED IAN. Платная операция - требуется кредит или запечатанный агент.

Параметры
  • agent_idstringобязательный

    Agent ID to get balance sheet for

  • as_of_epochnumber

    Optional: epoch number for historical balance. Default: current

  • include_pendingboolean

    Include pending (un-netted) receipts. Default: false

liquidate

Ликвидировать кредитную позицию (PAID - 5% от ликвидированной стоимости, SEAL REQUIRED)

Параметры
  • agent_idstringобязательный

    Lender agent ID

  • credit_line_idstringобязательный

    Credit line ID to liquidate

  • margin_call_idstringобязательный

    Associated margin call ID

  • request_hashstringобязательный

    Unique request hash for idempotency

lock_collateral

Заблокировать залог под кредитную линию (PAID - $10, SEAL REQUIRED)

Параметры
  • agent_idstringобязательный

    Borrower agent ID

  • amount_usd_microsnumberобязательный

    Collateral value in USD micros

  • asset_refstringобязательный

    Asset reference (e.g., 'ian:abc123', 'msr:def456')

  • asset_typeenumобязательный

    Type of collateral asset

  • credit_line_idstringобязательный

    Credit line ID

  • request_hashstringобязательный

    Unique request hash for idempotency

margin_call

Выставить или закрыть маржин-колл (ОПЛАЧЕНО - $100, ТРЕБУЕТСЯ ПЕЧАТЬ)

Параметры
  • actionenumобязательный

    Margin call action

  • agent_idstringобязательный

    Agent ID (lender for call, borrower for resolve)

  • credit_line_idstringобязательный

    Credit line ID

  • due_tsnumber

    Due timestamp (epoch ms)

  • margin_call_idstring

    Margin call ID (required for resolve/escalate)

  • reasonstring

    Reason for margin call

  • request_hashstringобязательный

    Unique request hash for idempotency

  • required_usd_microsnumber

    Amount required to meet margin

net_receipts

Объединить несколько чеков в подписанный IAN (операция PAID)

Параметры
  • agent_idstringобязательный

    Agent ID requesting the netting

  • receiptsobject[]обязательный

    Array of receipts to net together

open_credit_line

Открывает кредитную линию между заемщиком и кредитором (ОПЛАЧЕНО - 50 б.п. от лимита, ТРЕБУЕТСЯ ПЕЧАТЬ)

Параметры
  • borrower_agent_idstringобязательный

    Borrower agent ID (must have valid Primordia Seal)

  • collateral_ratio_min_bpsnumber

    Minimum collateral ratio in bps (default: 15000 = 150%)

  • lender_agent_idstringобязательный

    Lender agent ID

  • limit_usd_microsnumberобязательный

    Credit limit in USD micros (1 USD = 1,000,000 micros)

  • maturity_tsnumber

    Optional maturity timestamp (epoch ms)

  • request_hashstringобязательный

    Unique request hash for idempotency

  • spread_bpsnumber

    Interest rate spread in basis points (default: 200 = 2%)

repay_credit

Погасить основную сумму, проценты или комиссии по кредитной линии (FREE, SEAL REQUIRED)

Параметры
  • borrower_agent_idstringобязательный

    Borrower agent ID

  • credit_line_idstringобязательный

    Credit line ID to repay

  • fees_usd_microsnumber

    Fees amount to repay in USD micros

  • interest_usd_microsnumber

    Interest amount to repay in USD micros

  • principal_usd_microsnumber

    Principal amount to repay in USD micros

  • request_hashstringобязательный

    Unique request hash for idempotency

trigger_default

Запустить событие по умолчанию для агента (платная операция)

Параметры
  • agent_idstringобязательный

    Agent ID being defaulted

  • reasonstringобязательный

    Reason for the default (e.g., missed payment, insufficient collateral)

unlock_collateral

Разблокировать залог из кредитной линии (PAID - $10, SEAL REQUIRED)

Параметры
  • agent_idstringобязательный

    Borrower agent ID

  • collateral_lock_idstringобязательный

    Collateral lock ID to unlock

  • request_hashstringобязательный

    Unique request hash for idempotency

update_credit_line

Обновить параметры кредитной линии (ОПЛАЧЕНО - $10, ТРЕБУЕТСЯ ПЕЧАТЬ)

Параметры
  • agent_idstringобязательный

    Agent ID (borrower or lender)

  • credit_line_idstringобязательный

    Credit line ID to update

  • limit_usd_microsnumber

    New credit limit in USD micros

  • request_hashstringобязательный

    Unique request hash for idempotency

  • spread_bpsnumber

    New interest rate spread in bps

  • statusenum

    New status

verify_receipt

Проверить подпись квитанции MSR/IAN/FC (бесплатная операция)

Параметры
  • payloadobjectобязательный

    The receipt payload to verify

  • typeenumобязательный

    Receipt type: MSR (Micropayment Settlement Receipt), IAN (Inter-Agent Note), or FC (Future Commitment)

verify_seal

Проверить печать соответствия протоколу (бесплатная операция)

Параметры
  • sealobjectобязательный

    Conformance seal object to verify

Похожие MCP-сервера

akutishevsky/lunchmoney-mcp

akutishevsky/lunchmoney-mcp

MCP сервер для управления финансами через API LunchMoney. Открывает AI-ассистентам доступ к транзакциям, бюджетам и счетам. Автоматизация финансового учета: анализ расходов, синхронизация с банками. Работает с LunchMoney API v2.

TypeScript103
AbdelStark/bitcoin-mcp

AbdelStark/bitcoin-mcp

MCP-сервер для интеграции AI-агентов с Bitcoin и Lightning Network. Генерирует ключи, проверяет адреса, декодирует транзакции, запрашивает блокчейн и работает с Lightning-инвойсами. Полезен разрабо...

TypeScript76
W3Ship/w3ledger-mcp-server

W3Ship/w3ledger-mcp-server

W3Ledger — MCP-сервер для AI-агентов с криптографически заверенными транзакциями: проверка балансов токенов, создание и активация подарочных и спонсорских карт, покупки с двойными подписями. Подход...

TypeScript1
botwallet-co/mcp

botwallet-co/mcp

MCP сервер для AI-агентов с финансовой автономией: выставление счетов, оплата API и управление USDC-кошельком. Владелец задаёт лимиты и одобряет крупные транзакции. Использует FROST-подписи — без единого приватного ключа.

TypeScript3
intentos-labs/beeper-mcp

intentos-labs/beeper-mcp

MCP-сервер для выполнения транзакций beeper в Binance Smart Chain. Проверяйте балансы, переводите BNB и токены, меняйте их через PancakeSwap, покупайте/продавайте токены и забирайте награды. Полезен для автоматизации DeFi-операций.

Python3
IndigoProtocol/cardano-mcp

IndigoProtocol/cardano-mcp

MCP сервер для работы с блокчейном Cardano из AI-агентов и систем автоматизации. Предоставляет инструменты для подписи транзакций, проверки балансов, стейкинга и управления криптокошельком. Полезен разработчикам и пользователям Cardano, интегрирующим ИИ.

TypeScript4
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин