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 (заемщик или кредитор)

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

    Идентификатор кредитной линии

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

    Количество дней для начисления процентов

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

    Уникальный хэш запроса для идемпотентности

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

    Идентификатор окна начисления (например, 'window_2024_01')

apply_fee

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

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

    Идентификатор агента

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

    Сумма комиссии в микро-долларах США.

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

    Идентификатор кредитной линии

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

    Тип платежа

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

    Причина платы.

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

    Уникальный хэш запроса для идемпотентности

close_credit_line

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

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

    Agent ID (заемщик или кредитор)

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

    ID кредитной линии для закрытия

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

    Уникальный хэш запроса для идемпотентности

commit_future

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

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

    Agent ID, берущий на себя обязательство

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

    Объект Future Commitment с условиями обязательства, обеспечения и расчётов.

draw_credit

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

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

    Сумма к выводу в USD micros

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

    Идентификатор агента заемщика

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

    Идентификатор кредитной линии для списания средств

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

    Уникальный хэш запроса для идемпотентности

emit_meter

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

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

    Идентификатор агента, выдающего квитанцию счётчика

  • metadataobject

    Необязательные метаданные (модель, регион и т.д.)

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

    Идентификатор провайдера (например, 'openai', 'anthropic', 'aws')

  • submitboolean

    Если true, отправляет в ядро /v1/index/batch для последующего неттинга. По умолчанию: false (только локально).

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

    Тип метрики: 'compute' (токены GPU/CPU) или 'energy' (kWh)

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

    Цена за единицу в микродолларах США (1 USD = 1 000 000 микродолларов)

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

    Потреблённые единицы (токены для вычислений, кВт·ч для энергии)

get_balance_sheet

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

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

    ID агента, для которого получить балансовый отчёт

  • as_of_epochnumber

    Необязательно: номер эпохи для исторического баланса. По умолчанию: текущий.

  • include_pendingboolean

    Включает ожидающие (не сальдированные) квитанции. По умолчанию: false.

liquidate

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

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

    Lender agent ID

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

    ID кредитной линии для ликвидации

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

    Идентификатор связанного маржинального требования

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

    Уникальный хэш запроса для идемпотентности

lock_collateral

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

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

    Идентификатор агента заемщика

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

    Стоимость залога в USD micros

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

    Ссылка на ресурс (например, 'ian:abc123', 'msr:def456')

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

    Тип залогового актива

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

    Идентификатор кредитной линии

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

    Уникальный хэш запроса для идемпотентности

margin_call

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

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

    Действие при маржинальном требовании.

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

    Agent ID (кредитор для call, заёмщик для resolve)

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

    Идентификатор кредитной линии

  • due_tsnumber

    Срок (временная метка, мс с начала эпохи)

  • margin_call_idstring

    Идентификатор маржин-колла (обязателен для разрешения/эскалации)

  • reasonstring

    Причина маржинального требования

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

    Уникальный хэш запроса для идемпотентности

  • required_usd_microsnumber

    Сумма, необходимая для покрытия маржи.

net_receipts

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

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

    Agent ID, запрашивающий неттинг

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

    Массив чеков для взаимозачёта.

open_credit_line

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

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

    ID агента-заёмщика (требуется действительная Primordia Seal)

  • collateral_ratio_min_bpsnumber

    Минимальный коэффициент обеспечения в базисных пунктах (по умолчанию: 15000 = 150%)

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

    Lender agent ID

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

    Кредитный лимит в микро-долларах США (1 USD = 1 000 000 микро-долларов)

  • maturity_tsnumber

    Необязательная временная метка погашения (в миллисекундах от начала эпохи).

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

    Уникальный хэш запроса для идемпотентности

  • spread_bpsnumber

    Процентный спред в базисных пунктах (по умолчанию: 200 = 2%)

repay_credit

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

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

    Идентификатор агента заемщика

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

    ID кредитной линии для погашения

  • fees_usd_microsnumber

    Сумма комиссии к возврату в микродолларах США.

  • interest_usd_microsnumber

    Сумма процентов к погашению в микро-долларах США

  • principal_usd_microsnumber

    Основная сумма к погашению в микро-долларах США

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

    Уникальный хэш запроса для идемпотентности

trigger_default

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

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

    Agent ID устанавливается по умолчанию.

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

    Причина дефолта (например, пропущенный платёж, недостаточное обеспечение)

unlock_collateral

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

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

    Идентификатор агента заемщика

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

    ID блокировки залога для разблокировки

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

    Уникальный хэш запроса для идемпотентности

update_credit_line

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

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

    Agent ID (заемщик или кредитор)

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

    Идентификатор кредитной линии для обновления.

  • limit_usd_microsnumber

    Новый кредитный лимит в микро-USD

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

    Уникальный хэш запроса для идемпотентности

  • spread_bpsnumber

    Новый спред процентной ставки в базисных пунктах

  • statusenum

    Новый статус

verify_receipt

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

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

    Полезная нагрузка чека для проверки

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

    Тип квитанции: MSR (квитанция о расчетах по микроплатежам), IAN (межагентская записка) или FC (будущее обязательство)

verify_seal

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

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

    Проверяет объект знака соответствия.

0.1.0основная

Выберите клиент, чтобы установить oerc-s/primordia:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "oerc-s-primordia-z0mq89uemf": {
      "command": "npx",
      "args": [
        "@primordia1/mcp-server"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "oerc-s-primordia-z0mq89uemf": {
      "command": "npx",
      "args": [
        "@primordia1/mcp-server"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "oerc-s-primordia-z0mq89uemf": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@primordia1/mcp-server"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"oerc-s-primordia-z0mq89uemf\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"@primordia1/mcp-server\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "oerc-s-primordia-z0mq89uemf": {
      "command": "npx",
      "args": [
        "@primordia1/mcp-server"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add oerc-s-primordia-z0mq89uemf -- npx @primordia1/mcp-server

Либо через JSON-конфиг:

claude mcp add-json oerc-s-primordia-z0mq89uemf "{\"command\":\"npx\",\"args\":[\"@primordia1/mcp-server\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add oerc-s-primordia-z0mq89uemf -- npx @primordia1/mcp-server

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.oerc-s-primordia-z0mq89uemf]
command = "npx"
args = ["@primordia1/mcp-server"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите oerc-s/primordia, а в поле команды запуска — строку ниже:
npx @primordia1/mcp-server

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "oerc-s-primordia-z0mq89uemf": {
      "command": "npx",
      "args": [
        "@primordia1/mcp-server"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "oerc-s-primordia-z0mq89uemf": {
      "command": "npx",
      "args": [
        "@primordia1/mcp-server"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например oerc-s-primordia-z0mq89uemf.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: oerc-s-primordia-z0mq89uemf
    command: npx
    args:
      - "@primordia1/mcp-server"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "oerc-s-primordia-z0mq89uemf": {
      "command": "npx",
      "args": [
        "@primordia1/mcp-server"
      ]
    }
  }
}

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

W3Ship/w3ledger-mcp-server

W3Ship/w3ledger-mcp-server

от baskcart

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

TypeScript⭐ 1
xeroapi/xero-mcp-server

xeroapi/xero-mcp-server

от xeroapi

MCP сервер для интеграции с бухгалтерской платформой Xero. Управляйте контактами, счетами, отчетами через единый протокол. Поддержка OAuth2 и кастомных подключений. Идеально для бухгалтеров и разработчиков, автоматизирующих финансовые процессы.

TypeScript⭐ 383
botwallet-co/mcp

botwallet-co/mcp

от botwallet-co

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

TypeScript⭐ 4
LightSpeedPlusOne/invovate-mcp-server

LightSpeedPlusOne/invovate-mcp-server

от lightspeedplusone

Бесплатный MCP-сервер для генерации счетов без регистрации: создаёт PDF, JSON и UBL 2.1 счета на 11 языках. Работает с Claude, Cursor, Windsurf. Расчёт сумм без ключа, для PDF - бесплатный ключ.

JavaScript⭐ 1
untitledfinancial/dpx-mcp

untitledfinancial/dpx-mcp

от untitledfinancial

DPX MCP Server предоставляет AI-оракул для институциональных финансов и расчетный шлюз для USDC/EURC на Base mainnet. 13 инструментов для MCP-хостов: макросигналы, ESG-оценка, выполнение транзакций...

JavaScript⭐ 1
AbdelStark/bitcoin-mcp

AbdelStark/bitcoin-mcp

от abdelstark

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

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

Лука Никитин