webaesbyamin/agent-receipts

webaesbyamin/agent-receipts

от webaesbyamin
MCP сервер даёт AI-агентам память с криптографическими чеками. Каждый факт подписывается Ed25519, хранится локально без облака. Для разработчиков, нуждающихся в аудите действий агента.

Agent Receipts

Your AI agent remembers everything — and you can prove it.

Persistent memory for AI agents, backed by cryptographic receipts. Every fact your agent learns is signed, traceable, and independently verifiable. No cloud required.

Live Demo Interactive Walkthrough npm version License: MIT

Try the Interactive Demo · Install in 30 Seconds · How It's Different


The Problem

You're building with AI agents. Claude Code refactors your auth module and says "done, all tests pass." Your agent generates a customer quote and says it applied the right pricing. Your assistant remembers your preferences from last week — but you can't see why it thinks that, or whether it's right.

Three things are broken:

  1. Agents forget everything between sessions. Every conversation starts from zero. Context is lost. You re-explain the same things.

  2. When agents do remember, you can't see inside. Platform memory is a black box. You can't see what it stored, when, or why. You can't correct it, export it, or verify it.

  3. There's no proof of what agents actually did. Logs are mutable. Agents write their own logs. "I updated 3 files and all tests pass" — did it? You're trusting the agent's word about its own work.

Инструменты были проиндексированы:
cleanup

Удаляет чеки, срок действия которых истёк, на основе поля expires_at в metadata. Просроченными считаются чеки, у которых metadata.expires_at задано и меньше текущего времени. Поддерживает режим dry_run для предварительного просмотра удалений без фиксации. Возвращает количество удалённых чеков и оставшееся общее количество. Используйте периодически для управления хранилищем и применения политик TTL, заданных при создании чеков. Установите cleanup_memory, чтобы также выполнять мягкое удаление устаревших наблюдений памяти.

Параметры
  • cleanup_memoryboolean

    Also clean up expired memory observations (soft-delete). Defaults to false.

  • dry_runboolean

    If true, returns what would be deleted without actually deleting. Defaults to false.

complete_judgment

Отправляет результаты оценки, чтобы завершить ожидающий подтверждения чек, созданный judge_receipt. Записывает вердикт, общий балл, баллы по каждому критерию и обоснование, а также уверенность. Чек повторно подписывается с помощью Ed25519 и связывается с исходным через parent_receipt_id. Возвращает ID чека, вердикт, балл и ID цепочки. Используйте сразу после оценки промпта, возвращённого judge_receipt.

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

    Your confidence in this evaluation, 0.0 to 1.0

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

    Array of per-criterion results. Each item needs: criterion (name string), score (0.0-1.0), reasoning (explanation string)

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

    The pending judgment receipt ID returned by judge_receipt

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

    Overall explanation of the evaluation verdict

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

    Overall quality score from 0.0 to 1.0

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

    Overall evaluation result: "pass" (meets threshold), "fail" (below threshold), or "partial" (mixed results)

complete_receipt

Финализирует ожидающую квитанцию, записывая результаты выполнения, затраты и выходные данные. Обновляет статус квитанции на completed, failed или timeout и подписывает заново с помощью Ed25519. Используется после create_receipt, когда нужно записать результаты отдельно от создания (двухфазное отслеживание). Не может завершить уже завершённую квитанцию. Возвращает обновлённую подписанную квитанцию.

Параметры
  • callback_verifiedboolean | null

    Whether an external callback verified the result

  • confidencenumber | null

    Confidence score for output quality, 0.0 to 1.0

  • cost_usdnumber | null

    Total cost in USD

  • errorobject | null

    Error details if status is "failed" (e.g., {"code": "TIMEOUT", "message": "..."})

  • latency_msinteger | null

    Total execution time in milliseconds

  • modelstring | null

    AI model used during execution

  • output_hashstring | null

    Pre-computed SHA-256 hash of the output in format "sha256:hexstring"

  • output_summarystring | null

    Human-readable summary of the execution result

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

    The receipt ID to complete — must be a pending receipt (status: "pending")

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

    Final status: "completed" (success), "failed" (error occurred), or "timeout" (timed out)

  • tokens_ininteger | null

    Input tokens consumed

  • tokens_outinteger | null

    Output tokens generated

  • tool_callsstring[] | null

    Names of tools called during execution

create_receipt

Создаёт подписанный Ed25519 чек с предварительно вычисленными хешами SHA-256. Используйте, когда вы уже хешировали входные/выходные данные внешне или вам нужен полный контроль над полями чека. Для автоматического хеширования используйте track_action. Возвращает подписанный объект чека с receipt_id. Чек сохраняется локально в SQLite, и его можно завершить позже с помощью complete_receipt.

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

    Action name being recorded (e.g., "generate_code", "analyze_data")

  • chain_idstring

    Chain ID (auto-generated if not provided)

  • confidencenumber | null

    Confidence score 0-1

  • constraintsobject[]

    Array of constraint definitions to evaluate (types: max_latency_ms, max_cost_usd, min_confidence, required_fields, status_must_be, output_schema)

  • cost_usdnumber | null

    Cost in USD

  • expires_atstring

    ISO datetime when this receipt expires

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

    Pre-computed SHA-256 hash of the input data in format "sha256:hexstring"

  • latency_msinteger | null

    Latency in milliseconds

  • metadataobject

    Arbitrary metadata

  • modelstring | null

    AI model used

  • output_hashstring | null

    Pre-computed SHA-256 hash of the output data in format "sha256:hexstring"

  • output_summarystring | null

    Human-readable summary of the output

  • parent_receipt_idstring | null

    Parent receipt ID for chains

  • receipt_typeenum

    Receipt type: "action" (default), "verification", "judgment", or "arbitration"

  • statusenum

    Initial status: "pending" (default, complete later) or "completed"

  • tagsstring[] | null

    Tags for categorization

  • tokens_ininteger | null

    Input tokens

  • tokens_outinteger | null

    Output tokens

  • tool_callsstring[] | null

    Tools called during the action

  • ttl_msnumber

    Time-to-live in milliseconds from now

generate_invoice

Генерирует счёт клиенту из криптографически подписанных чеков за указанный диапазон дат. Агрегирует данные чеков по агенту, действию или дню и вычисляет общую стоимость, использование токенов и количество чеков. Поддерживает форматы вывода JSON, CSV и Markdown. Каждая позиция счёта ссылается на подписанный чек для проверяемой выписки. Используется для выставления счетов клиентам за работу AI-агентов с криптографическим доказательством каждого оплачиваемого действия.

Параметры
  • actionsstring[]

    Filter to specific action names only

  • agent_idsstring[]

    Filter to specific agent IDs only

  • client_emailstring

    Client email address

  • client_namestring

    Client or bill-to name for the invoice header

  • constraints_passed_onlyboolean

    If true, only include receipts where all constraints passed

  • formatenum

    Output format: "json" (structured data), "csv" (spreadsheet), or "md" (markdown table)

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

    Invoice period start date in ISO 8601 format (e.g., "2026-01-01" or "2026-01-01T00:00:00Z")

  • group_byenum

    How to group line items: "action" (by action name), "agent" (by agent ID), "day" (by date), or "none" (single total)

  • include_receiptsboolean

    If true, includes full receipt objects in JSON output for full auditability

  • notesstring

    Additional notes to include in the invoice

  • payment_termsstring

    Payment terms text (e.g., "Net 30", "Due on receipt")

  • provider_emailstring

    Your email address

  • provider_namestring

    Your company or provider name

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

    Invoice period end date in ISO 8601 format (e.g., "2026-01-31" or "2026-01-31T23:59:59Z")

get_chain

Получает все квитанции, принадлежащие цепочке, отсортированные по временной метке по возрастанию, чтобы показать последовательность операций. Цепочка группирует связанные квитанции из многошагового рабочего процесса агента. Возвращает полные объекты квитанций для каждого шага. Используйте для аудита полного рабочего процесса, расчета общей стоимости и длительности цепочки или определения того, на каком этапе пайплайна произошел сбой.

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

    The chain ID to retrieve (format: "chain_" followed by 8 alphanumeric characters)

get_judgments

Извлекает все судебные квитанции, связанные с заданным ID квитанции. Судебные квитанции связаны через parent_receipt_id. Возвращает массив объектов судебных квитанций, отсортированный по временной метке, включая вердикт, оценку, результаты критериев и уверенность. Используйте для просмотра истории оценки квитанции, сравнения нескольких судебных решений или аудита оценок качества ИИ. Возвращает пустой массив, если судебные решения отсутствуют.

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

    The original receipt ID to get judgments for (not the judgment receipt ID)

get_public_key

Экспортирует открытый ключ Ed25519, используемый для подписи всех чеков в этом экземпляре. Возвращает ключ в виде 64-символьной шестнадцатеричной строки. Поделитесь этим ключом с клиентами или третьими сторонами, чтобы они могли самостоятельно проверять подписи чеков без доступа к вашему закрытому ключу. Закрытый ключ никогда не покидает вашу машину - для проверки нужен только открытый ключ.

Параметры

Без параметров.

get_receipt

Извлекает один чек по его ID из локального хранилища SQLite. Возвращает полный объект чека, включая все 27 полей: идентификатор, временные метки, данные действия, метрики производительности, ограничения, криптографическое доказательство и метаданные. Возвращает сообщение об ошибке, если ID чека не существует. Используйте для просмотра конкретного чека или его получения перед верификацией.

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

    The receipt ID to retrieve (format: "rcpt_" followed by 12 alphanumeric characters)

get_started

Отображает руководство по началу работы с примерами использования для всех инструментов Agent Receipts. Показывает, как записывать действия агента, проверять квитанции, использовать цепочки квитанций, оценивать с учётом ограничений и создавать счета. Вызывайте этот инструмент в первую очередь при настройке Agent Receipts или когда вам нужна справка по доступным инструментам и типичным способам их использования.

Параметры

Без параметров.

judge_receipt

Начинает оценку AI-суждения для ресипта, создавая отложенный ресипт суждения и возвращая структурированный запрос на оценку. Хост-модель (вы) оценивает выход ресипта по предоставленным критериям рубрики, а затем вызывает complete_judgment с результатами. Используется для оценки качества вывода за пределами простых ограничений «пройдено/не пройдено»: поддерживает взвешенные критерии, частичные вердикты и оценки уверенности. Ресипты суждений сами подписаны Ed25519 для аудита.

Параметры
  • output_summary_for_reviewstring

    The actual output content to evaluate — provide if output_summary on the receipt is insufficient for evaluation

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

    The receipt ID to evaluate — the original action receipt

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

    Evaluation rubric with criteria array. Each criterion needs: name (string), description (string), weight (0.0-1.0), and optional passing_threshold (0.0-1.0, default 0.7). Also set: passing_threshold (overall, default 0.7) and require_all (boolean, default false)

list_receipts

Запрашивает и постранично выводит квитанции из локального хранилища SQLite с возможностью фильтрации по агенту, действию, статусу, окружению, типу, цепочке или тегу. Сортирует по временной метке, стоимости или задержке. Возвращает постраничные результаты с общим количеством, информацией о странице и флагами has_next/has_prev. По умолчанию: 50 квитанций на странице, сортировка по временной метке по убыванию. Используйте для аудита активности агентов, создания отчётов или поиска конкретных квитанций.

Параметры
  • actionstring

    Filter by action name (exact match)

  • agent_idstring

    Filter by agent ID (exact match)

  • chain_idstring

    Filter to receipts in a specific chain

  • environmentenum

    Filter by environment: "development", "production", "staging", or "test"

  • limitinteger

    Results per page, 1 to 100 (default: 50)

  • pageinteger

    Page number, starting at 1 (default: 1)

  • receipt_typeenum

    Filter by type: "action", "verification", "judgment", or "arbitration"

  • sortstring

    Sort field and direction in format "field:asc" or "field:desc" (e.g., "timestamp:desc", "cost_usd:asc")

  • statusenum

    Filter by status: "pending", "completed", "failed", or "timeout"

  • tagstring

    Filter to receipts containing this tag

memory_audit

Генерирует аудиторский отчёт операций с памятью. Показывает, что было запомнено, забыто, объединено и какими агентами за определённый период времени.

Параметры
  • agent_idstring

    Filter by agent

  • entity_idstring

    Filter by entity

  • fromstring

    Start date (ISO 8601)

  • tostring

    End date (ISO 8601)

memory_context

Получает полный дамп памяти всех сохранённых воспоминаний: главные сущности, последние наблюдения, активные связи и предпочтения. Вызывайте это в начале разговора, чтобы понять, что уже известно о пользователе, его проектах и предпочтениях. Каждое извлечение контекста регистрируется как подписанная квитанция.

Параметры
  • auditedboolean

    Create a signed receipt for this read operation (default: false)

  • max_entitiesnumber

    Maximum entities to return, ordered by activity (default: 10, max: 50)

  • max_observationsnumber

    Maximum recent observations to return (default: 20, max: 100)

  • scopeenum

    Filter memories by scope (default: returns all accessible scopes)

memory_entities

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

Параметры
  • entity_typeenum
  • include_forgottenboolean

    Include forgotten entities (default: false)

  • limitnumber

    Max results (default: 20)

  • querystring

    Search entity names and aliases

  • scopeenum
memory_export_bundle

Экспортирует воспоминания как портативный, верифицируемый пакет. Включает сущности, наблюдения, отношения, подтверждения источников и открытый ключ, необходимый для их проверки. Передаёт другим агентам или импортирует в другой экземпляр Agent Receipts.

Параметры
  • descriptionstring

    Description of what this bundle contains

  • entity_idsstring[]

    Export specific entities (default: all)

  • include_forgottenboolean

    Include forgotten/deleted memories (default: false)

  • include_receiptsboolean

    Include source receipts for verification (default: true)

memory_forget

Забывает конкретное наблюдение или целую сущность. Это мягкое удаление - память помечается как забытая, но сохраняется для аудита. Сама операция забывания записывается как подписанное подтверждение.

Параметры
  • entity_idstring

    Entity to forget entirely (all its observations)

  • observation_idstring

    Specific observation to forget

  • reasonstring

    Why this memory is being forgotten

memory_import_bundle

Импортирует пакет памяти из другого экземпляра Agent Receipts. Проверяет контрольные суммы перед импортом. Пропускает воспоминания, которые уже существуют локально. Сама операция импорта записывается как подписанное подтверждение.

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

    The memory bundle JSON object to import

  • skip_existingboolean

    Skip entities/observations that already exist (default: true)

memory_observe

Сохраняет наблюдение в памяти о человеке, проекте, предпочтении или любой сущности. Автоматически создаёт сущность, если она не существует. Каждое наблюдение криптографически подписано и привязано к квитанции.

Параметры
  • confidenceenum

    How confident you are in this observation (default: medium)

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

    The observation/fact to remember

  • contextstring

    What conversation or task produced this observation

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

    Name of the entity (person, project, tool, etc.)

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

    Type of entity

  • scopeenum

    Who can see this memory (default: agent)

  • tagsstring[]

    Tags for categorization

  • ttl_secondsnumber

    Time-to-live in seconds. After this duration, the observation expires and is excluded from recall but retained for audit.

memory_provenance

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

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

    The observation to trace

memory_recall

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

Параметры
  • auditedboolean

    Create a signed receipt for this read operation (default: false)

  • entity_idstring

    Get memories for a specific entity

  • entity_typeenum

    Filter by entity type

  • include_forgottenboolean

    Include soft-deleted memories (default: false)

  • limitnumber

    Max results to return (default: 20, max: 100)

  • querystring

    Text to search for across all observations

  • scopeenum

    Filter by memory scope

memory_relate

Создаёт отношение между двумя сущностями (например, "Amin" создаёт "ModQuote"). Отношения двунаправленные для запросов, но хранятся с направлением.

Параметры
  • contextstring

    What established this relationship

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

    Source entity ID

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

    Type of relationship (e.g., "builds", "uses", "works_at", "prefers")

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

    Target entity ID

track_action

Создаёт завершённую квитанцию с подписью Ed25519 для действия AI-агента с автоматическим хэшированием входных и выходных данных по SHA-256. Записывает использование модели, затраты, задержку и оценки ограничений. Возвращает подписанную квитанцию с receipt_id для дальнейшего использования. Используйте это как основной инструмент для записи действий агента - вместо create_receipt + complete_receipt для одношаговых действий.

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

    Action name being recorded (e.g., "generate_code", "summarize_text", "classify_intent")

  • chain_idstring

    Chain identifier for grouping related receipts — auto-generated if not provided

  • confidencenumber

    Confidence score for the output quality, 0.0 to 1.0

  • constraintsobject[]

    Constraint definitions to evaluate against this receipt (e.g., max_latency_ms, max_cost_usd, min_confidence)

  • cost_usdnumber

    Execution cost in USD (e.g., 0.0045)

  • expires_atstring

    ISO 8601 datetime when this receipt expires (e.g., "2026-12-31T23:59:59Z")

  • inputany

    Input data passed to the agent — automatically hashed with SHA-256, raw data is never stored

  • latency_msinteger

    Total execution time in milliseconds

  • metadataobject

    Arbitrary key-value metadata attached to the receipt

  • modelstring

    AI model used (e.g., "claude-sonnet-4-20250514", "gpt-4o", "gemini-2.0-flash")

  • outputany

    Output produced by the agent — automatically hashed with SHA-256, raw data is never stored

  • output_summarystring

    Human-readable summary of the output for audit purposes (max 500 chars recommended)

  • parent_receipt_idstring

    Parent receipt ID for chaining — links this receipt to a previous step

  • tagsstring[]

    Arbitrary tags for filtering and categorization (e.g., ["production", "critical"])

  • tokens_ininteger

    Input tokens consumed by the model

  • tokens_outinteger

    Output tokens generated by the model

  • tool_callsstring[]

    Names of tools called during this action (e.g., ["web_search", "code_exec"])

  • ttl_msnumber

    Time-to-live in milliseconds from now — alternative to expires_at

verify_receipt

Криптографически проверяет подпись Ed25519 на сохранённой квитанции, чтобы подтвердить, что она не была изменена с момента подписания. Извлекает подписываемую полезную нагрузку из 12 полей, канонизирует её и проверяет по сохранённому открытому ключу. Возвращает verified: true, если подпись действительна. Используется для аудита квитанций перед их применением в качестве доказательства или перед завершением платежей на основе работы агента.

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

    The receipt ID to verify — must exist in local storage

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

Kzino/vorim-mcp-server

Kzino/vorim-mcp-server

MCP-сервер Vorim AI даёт каждому AI-агенту криптографическую идентичность (Ed25519), гибкие разрешения с временными ограничениями и защищённый аудит. Работает с Claude Desktop, Cursor и любыми MCP-...

JavaScript73
memstate-ai/memstate-mcp

memstate-ai/memstate-mcp

Сервер версионированной памяти для AI-агентов — хранит факты, отслеживает их изменения и автоматически обнаруживает конфликты. В отличие от RAG, использует точное key-value хранение вместо эмбеддин...

TypeScript8
topskychen/tilde

topskychen/tilde

MCP-сервер для хранения профиля и памяти AI-агентов. Хранит данные локально, управляет навыками, опытом, резюме и командными стандартами. Избавляет от повторения контекста при смене инструментов.

Python4
mnemoverse/mcp-memory-server

mnemoverse/mcp-memory-server

MCP сервер для долговременной памяти AI-агентов, работающий через единый API-ключ в Claude, Cursor, VS Code и ChatGPT. Запоминает факты, предпочтения и уроки между сессиями и проектами. Фидбек улучшает релевантность, а забывание по давности делает память самоочищающейся.

TypeScript21
PV-Bhat/vibe-check-mcp-server

PV-Bhat/vibe-check-mcp-server

Vibe Check MCP — это сервер-метаментор для AI-агентов на базе MCP. Он внедряет Chain-Pattern Interrupts (CPI) для предотвращения ошибочных стратегий, повышая успешность на 27% и снижая вредоносные ...

TypeScript502
Goldentrii/AgentRecall

Goldentrii/AgentRecall

AgentRecall — MCP сервер, который запоминает каждое исправление агента и учится на ошибках. Пять слоев памяти (коррекции, эпизоды, навыки) хранятся локально в markdown. Инструмент полезен разработчикам ИИ-агентов: он автоматически анализирует повторные недочеты и повышает точность работы, не треб...

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

Лука Никитин