{"id":300903,"recorded_at":"2026-10-26T22:28:42.102471Z","observed_at":"2026-10-26T22:28:42.102315Z","subject_kind":"endpoint","subject":"5e074d60-21e1-4319-a328-623fe962b982","kind":"mcp.tools","method":"probe.mcp/1","body":{"count":17,"tools":[{"description":"WRITE — adds a comment to an invoice (visible in its activity log). POST /invoice/{invoiceId}/comment.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"invoiceId":{"description":"Invoice ID to comment on.","type":"string"},"text":{"description":"Comment text.","type":"string"},"userId":{"description":"ID or foreign ID of the user creating the comment.","type":"string"}},"required":["invoiceId","text"],"type":"object"},"name":"mercoa_add_invoice_comment"},{"description":"WRITE — creates a real entity (customer/vendor/payor/payee) in Mercoa. Supply role flags, accountType, and a nested `profile` object (business or individual details). POST /entity.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"accountType":{"description":"business or individual.","enum":["business","individual"],"type":"string"},"email":{"description":"Primary email for the entity.","type":"string"},"foreignId":{"description":"Your system's ID for this entity.","type":"string"},"isCustomer":{"description":"Whether this entity has a direct relationship with your organization.","type":"boolean"},"isPayee":{"description":"Whether this entity can receive payments (AR / vendor).","type":"boolean"},"isPayor":{"description":"Whether this entity can pay invoices (AP).","type":"boolean"},"profile":{"additionalProperties":{},"description":"Nested profile object, e.g. { \"business\": { \"legalBusinessName\": \"Acme Inc.\", \"email\": \"ap@acme.com\", \"businessType\": \"llc\" } } or { \"individual\": { \"name\": {...}, \"email\": \"...\" } }.","propertyNames":{"type":"string"},"type":"object"}},"type":"object"},"name":"mercoa_create_entity"},{"description":"WRITE — creates a real invoice/bill in Mercoa. Set status (DRAFT to stage, NEW to submit), amount, currency, payer/vendor, dates and line items. POST /invoice.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"amount":{"description":"Total invoice amount.","type":"number"},"creatorEntityId":{"description":"Entity ID on whose behalf the invoice is created.","type":"string"},"creatorUserId":{"description":"User ID creating the invoice.","type":"string"},"currency":{"description":"Currency code, e.g. USD.","type":"string"},"deductionDate":{"description":"Scheduled payment/deduction date (ISO 8601).","type":"string"},"dueDate":{"description":"Due date (ISO 8601).","type":"string"},"invoiceDate":{"description":"Invoice date (ISO 8601).","type":"string"},"invoiceNumber":{"description":"Human-readable invoice number, e.g. INV-123.","type":"string"},"lineItems":{"description":"Line items array, e.g. [{ \"amount\": 100, \"currency\": \"USD\", \"description\": \"Product A\", \"quantity\": 1, \"unitPrice\": 100 }].","items":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":"object"},"type":"array"},"metadata":{"additionalProperties":{},"description":"Arbitrary key/value metadata.","propertyNames":{"type":"string"},"type":"object"},"noteToSelf":{"description":"Internal note.","type":"string"},"payerId":{"description":"Payer entity ID (who owes).","type":"string"},"paymentDestinationId":{"description":"Payment method ID to pay to (vendor's).","type":"string"},"paymentSourceId":{"description":"Payment method ID to pay from (payer's).","type":"string"},"status":{"description":"Invoice status, e.g. DRAFT, NEW, APPROVED, SCHEDULED.","type":"string"},"vendorId":{"description":"Vendor entity ID (who is paid).","type":"string"}},"type":"object"},"name":"mercoa_create_invoice"},{"description":"Find/search entities (buyers, vendors, payors, payees). Use to look up counterparties by name/email/foreignId or list all. GET /entity.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"foreignId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Your system's ID(s) for the entity."},"isCustomer":{"description":"If true, only entities with a direct relationship to your organization.","type":"boolean"},"isPayee":{"description":"Filter entities marked as payees.","type":"boolean"},"isPayor":{"description":"Filter entities marked as payors.","type":"boolean"},"limit":{"description":"Max entities to return (1-100, default 10).","exclusiveMinimum":0,"maximum":100,"type":"integer"},"paymentMethods":{"description":"If true, include payment methods in the response.","type":"boolean"},"returnMetadata":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Metadata key(s) to include in the response."},"search":{"description":"Search by name, email, emailTo, entity ID, or foreign ID (partial matches).","type":"string"},"startingAfter":{"description":"Entity ID cursor for pagination.","type":"string"},"status":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Entity status filter (e.g. verified, pending)."}},"type":"object"},"name":"mercoa_find_entities"},{"description":"Find/search invoices (bills) across payers and vendors. Filter by status, entity, date, approver and more. GET /invoices (plural list endpoint).","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"approverAction":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by approver action (use with approverId), e.g. APPROVE."},"approverId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by assigned approver user ID(s)."},"creatorUserId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by the user ID(s) that created the invoice."},"dateType":{"description":"Date type to filter by (e.g. CREATED_AT, DUE_DATE).","type":"string"},"endDate":{"description":"End date filter (ISO 8601).","type":"string"},"entityGroupId":{"description":"Filter by entity group ID.","type":"string"},"entityId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by entity (payer or vendor) ID(s) or foreign ID(s)."},"invoiceId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by invoice ID(s) or foreign ID(s)."},"invoiceTemplateId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by invoice template ID(s)."},"limit":{"description":"Max invoices to return (1-100, default 10).","exclusiveMinimum":0,"maximum":100,"type":"integer"},"orderBy":{"description":"Field to order by (e.g. CREATED_AT, AMOUNT, DUE_DATE).","type":"string"},"orderDirection":{"description":"asc or desc.","type":"string"},"payerId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by payer ID(s) or foreign ID(s)."},"paymentType":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by payment type (e.g. recurring)."},"returnPayerMetadata":{"description":"Include payer metadata in the response.","type":"boolean"},"returnPaymentTiming":{"description":"Include payment timing in the response.","type":"boolean"},"returnVendorMetadata":{"description":"Include vendor metadata in the response.","type":"boolean"},"search":{"description":"Search by vendor name, invoice number, check number, or amount.","type":"string"},"startDate":{"description":"Start date filter (ISO 8601).","type":"string"},"startingAfter":{"description":"Invoice ID cursor for pagination.","type":"string"},"status":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Invoice status filter (e.g. DRAFT, NEW, APPROVED, SCHEDULED, PAID)."},"vendorId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by vendor ID(s) or foreign ID(s)."}},"type":"object"},"name":"mercoa_find_invoices"},{"description":"List/search payment transactions. Filter by entity, invoice, status, type and date. GET /transactions.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"endDate":{"description":"CREATED_AT end date filter (ISO 8601).","type":"string"},"entityGroupId":{"description":"Filter by entity group ID.","type":"string"},"entityId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by entity ID(s) or foreign ID(s)."},"invoiceId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by invoice ID(s) or foreign ID(s)."},"limit":{"description":"Max transactions to return (1-100, default 10).","exclusiveMinimum":0,"maximum":100,"type":"integer"},"payerId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by payer ID(s)."},"search":{"description":"Search by vendor name, invoice number, check number, or amount.","type":"string"},"startDate":{"description":"CREATED_AT start date filter (ISO 8601).","type":"string"},"startingAfter":{"description":"Transaction ID cursor for pagination.","type":"string"},"status":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Transaction status filter."},"transactionId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by transaction ID(s)."},"transactionType":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by transaction type."},"vendorId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by vendor ID(s)."}},"type":"object"},"name":"mercoa_find_transactions"},{"description":"Get a single entity by ID (or foreign ID). GET /entity/{entityId}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"entityId":{"description":"Entity ID (e.g. ent_...) or foreign ID.","type":"string"}},"required":["entityId"],"type":"object"},"name":"mercoa_get_entity"},{"description":"Get the event/audit log for an entity. GET /entity/{entityId}/events.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"endDate":{"description":"End date filter (ISO 8601).","type":"string"},"entityId":{"description":"Entity ID or foreign ID.","type":"string"},"limit":{"description":"Max events to return (1-100).","exclusiveMinimum":0,"maximum":100,"type":"integer"},"startDate":{"description":"Start date filter (ISO 8601).","type":"string"},"startingAfter":{"description":"Event ID cursor for pagination.","type":"string"}},"required":["entityId"],"type":"object"},"name":"mercoa_get_entity_events"},{"description":"Get aggregate invoice metrics (totals/counts, grouped by currency) for an entity's payables/receivables — for AP/AR dashboards and aging. GET /entity/{entityId}/invoice-metrics.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"approverId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by assigned approver user ID(s)."},"currency":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Currency code(s) to filter on, e.g. USD."},"dateType":{"description":"Date type to filter by (e.g. CREATED_AT, DUE_DATE).","type":"string"},"endDate":{"description":"End date filter (ISO 8601).","type":"string"},"entityId":{"description":"Entity ID or foreign ID.","type":"string"},"excludePayables":{"description":"Only return receivables (exclude payables).","type":"boolean"},"excludeReceivables":{"description":"Only return payables (exclude receivables).","type":"boolean"},"groupBy":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Additional grouping (e.g. by status)."},"invoiceId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by invoice ID(s) or foreign ID(s)."},"payerId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by payer ID(s)."},"returnByDate":{"description":"Group metrics by date, e.g. CREATION_DATE or DUE_DATE.","type":"string"},"returnByDateFrequency":{"description":"Frequency for date grouping (e.g. DAILY, MONTHLY).","type":"string"},"search":{"description":"Search by vendor name, invoice number, check number, or amount.","type":"string"},"startDate":{"description":"Start date filter (ISO 8601).","type":"string"},"status":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Invoice status filter (e.g. NEW, SCHEDULED, PAID)."},"vendorId":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"description":"Filter by vendor ID(s)."}},"required":["entityId"],"type":"object"},"name":"mercoa_get_entity_invoice_metrics"},{"description":"Get a single invoice (bill) by ID. GET /invoice/{invoiceId}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"invoiceId":{"description":"Invoice ID (e.g. in_...) or foreign ID.","type":"string"}},"required":["invoiceId"],"type":"object"},"name":"mercoa_get_invoice"},{"description":"Get the event/audit log for an invoice (status changes, approvals, payments). GET /invoice/{invoiceId}/events.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"endDate":{"description":"End date filter (ISO 8601).","type":"string"},"invoiceId":{"description":"Invoice ID or foreign ID.","type":"string"},"limit":{"description":"Max events to return (1-100).","exclusiveMinimum":0,"maximum":100,"type":"integer"},"startDate":{"description":"Start date filter (ISO 8601).","type":"string"},"startingAfter":{"description":"Event ID cursor for pagination.","type":"string"}},"required":["invoiceId"],"type":"object"},"name":"mercoa_get_invoice_events"},{"description":"Get the caller's Mercoa organization configuration (settings, payment methods enabled, etc.). GET /organization.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{},"type":"object"},"name":"mercoa_get_organization"},{"description":"Get a single payment method for an entity. GET /entity/{entityId}/paymentMethod/{paymentMethodId}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"entityId":{"description":"Entity ID or foreign ID.","type":"string"},"paymentMethodId":{"description":"Payment method ID (e.g. pm_...).","type":"string"}},"required":["entityId","paymentMethodId"],"type":"object"},"name":"mercoa_get_payment_method"},{"description":"Get a single payment transaction by ID. GET /transaction/{transactionId}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"transactionId":{"description":"Transaction ID.","type":"string"}},"required":["transactionId"],"type":"object"},"name":"mercoa_get_transaction"},{"description":"List an entity's payment methods (bank accounts, cards, check, etc.). GET /entity/{entityId}/paymentMethods.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"entityId":{"description":"Entity ID or foreign ID.","type":"string"},"type":{"description":"Filter by payment method type (e.g. bankAccount, card, check).","type":"string"}},"required":["entityId"],"type":"object"},"name":"mercoa_list_entity_payment_methods"},{"description":"List the users belonging to an entity (approvers, admins, etc.). GET /entity/{entityId}/users.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"entityId":{"description":"Entity ID or foreign ID.","type":"string"}},"required":["entityId"],"type":"object"},"name":"mercoa_list_entity_users"},{"description":"WRITE — updates an existing invoice/bill (all fields optional). Commonly used to advance status (e.g. DRAFT→NEW→SCHEDULED) or change amounts, dates, or payment methods. POST /invoice/{invoiceId}.","inputSchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"amount":{"description":"Total invoice amount.","type":"number"},"currency":{"description":"Currency code, e.g. USD.","type":"string"},"deductionDate":{"description":"Scheduled payment/deduction date (ISO 8601).","type":"string"},"dueDate":{"description":"Due date (ISO 8601).","type":"string"},"invoiceDate":{"description":"Invoice date (ISO 8601).","type":"string"},"invoiceId":{"description":"Invoice ID to update.","type":"string"},"invoiceNumber":{"description":"Human-readable invoice number.","type":"string"},"lineItems":{"description":"Replacement line items array.","items":{"additionalProperties":{},"propertyNames":{"type":"string"},"type":"object"},"type":"array"},"metadata":{"additionalProperties":{},"description":"Arbitrary key/value metadata.","propertyNames":{"type":"string"},"type":"object"},"noteToSelf":{"description":"Internal note.","type":"string"},"payerId":{"description":"Payer entity ID.","type":"string"},"paymentDestinationId":{"description":"Payment method ID to pay to.","type":"string"},"paymentSourceId":{"description":"Payment method ID to pay from.","type":"string"},"status":{"description":"New invoice status, e.g. NEW, APPROVED, SCHEDULED.","type":"string"},"vendorId":{"description":"Vendor entity ID.","type":"string"}},"required":["invoiceId"],"type":"object"},"name":"mercoa_update_invoice"}]},"body_sha256":"c9974bd49b5df04b2c7d5dfaae4e0a50d044a4e6b6cac43e09dc944011139e24","prev_id":null,"leaf":"0x4eb0266901f8d350181a38c7b6089ea31458a37e63278e65e978ed1479870ba8","leaf_text":"{\"body\":\"c9974bd49b5df04b2c7d5dfaae4e0a50d044a4e6b6cac43e09dc944011139e24\",\"id\":300903,\"kind\":\"mcp.tools\",\"method\":\"probe.mcp/1\",\"observed_us\":1793053722102315,\"prev\":null,\"subject\":\"5e074d60-21e1-4319-a328-623fe962b982\",\"subject_kind\":\"endpoint\"}","day":{"day":"2026-10-26","leaves":296695,"root":"0xf43e8dcc3d451a4788b26be904c55e8c4c0fa75c9666796c51db38d37e2c0df8","chained":"0x702d5ac508f08b0d1accf36af25822d8e5660367494edd17a642fb61e158a57a","anchor_chain":"eip155:5042002","anchor_tx":"0x495162f8936e19f0039918feebe6c307f327cd6bf8c37219620b1970041fa9ae","anchor_block":69251483},"proof":["0x4eb026d8b51a1a6e00cfff410e9dde4f3bcc136fd72afab506ec78346499a32d","0xb6e58aa2421bd00e513a663a22d395290c12a93a0257ff2e35539eb63d29391a","0x67037ff5ca50699c4a10933d2bc74e6d4b72222c01338deb1b5c8155465dcfc1","0xd0becb31b7038fdf3e6d016efd84a6402aa59ff66b657b20368df9b91c4bba21","0x11c4d0dc2f3c8834ebdd7a470d2b85eae4542582b9cf46ac4d90c56aff4304a9","0xdc512ce4a2a1c05c5d14ce6a6681471c392b90681bd8d297999dc610f34f16e1","0x0375abc1f3b890ed67b80451b18f2b23311beb3dd1c317fb0108f6a43d42b037","0xad331b1bfe6fda98a3443e78e66dfb2aa5f9f18b3924e8d522a13debeb6018a2","0xb5a2ff57df9c49538a0db5306ddc37af974a8caaa04dd03823b77e9b0412f004","0x3c2a519207c7fbe7025a4c98d41e42ecc9446b3fb0b1dbff629a91c8c74e0781","0x20ba86fd56bddd46212d02e792b969e90a1167c4fb9ba4a54cb7da5cf7da1629","0xaf14a84837a57dc5a0cb0ebd158daaad24c19301b9257d9e97c322a7d8c54bc0","0xf7d2cf278e5d2768b8bdb70730c378877cf7165d8efcbec8bcd3282fdc50d177","0x0733993143f0230e79482cef2c38e95d98f9eafbe64a43cdc74a4545938a4167","0x2be1e80e065dd6b2cc75a7142be22225acd144ac975d70bf24b4f01fd76dc497","0x2e6a32eb32761c210560e852405e2f865f958ddbe01027894f8b9c1b3433b9f0","0x9a83be955a206deb65b995adfd92c58fa31c95fbbf926bd199d300e70b08b26d","0x20704208aa6923d6b2450ef74ede87a6e0265d46447926038fe9506e9e154b2d","0x9b9ce5b74b9bab5121612ef6b64920a8d453cbf311096a423eef9702747e868a"]}