{"openapi":"3.1.0","info":{"title":"Modern Treasury (BYOK) API","version":"0.1.0","description":"Modern Treasury (BYOK) lets an AI assistant read your own Modern Treasury data through the Modern Treasury API with a key you supply (organization ID). Read-only: 10 tools (list_payment_orders, get_payment_order, list_internal_accounts, list_transactions, list_expected_payments, list_incoming_payment_details, list_returns, list_balance_reports, list_invoices, list_events). The BYOK key travels...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-moderntreasury.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-moderntreasury/docs"},"termsOfService":"https://connectorbay.com/byok-moderntreasury/terms"},"servers":[{"url":"https://byok-moderntreasury.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-moderntreasury/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_payment_orders":{"post":{"operationId":"list_payment_orders","summary":"List payment orders with type, direction, amount in minor units, status, dates, counterparty, originating and receiving ","description":"List payment orders with type, direction, amount in minor units, status, dates, counterparty, originating and receiving accounts. Use for \"Which Modern Treasury payment orders are still pending or need approval\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"status":{"anyOf":[{"enum":["approved","cancelled","completed","denied","failed","held","needs_approval","pending","processing","returned","reversed","sent","stopped"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this status.","title":"Status"},"direction":{"anyOf":[{"enum":["credit","debit"],"type":"string"},{"type":"null"}],"default":null,"description":"Only credits or debits.","title":"Direction"},"type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only this payment type, for example ach, wire, check, book or rtp.","title":"Type"},"counterparty_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only payment orders to this counterparty id.","title":"Counterparty Id"},"originating_account_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only payment orders from this internal account id.","title":"Originating Account Id"},"effective_date_start":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only payment orders effective on or after this date. Format YYYY-MM-DD.","title":"Effective Date Start"},"effective_date_end":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only payment orders effective on or before this date. Format YYYY-MM-DD.","title":"Effective Date End"},"created_at_start":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only payment orders created on or after this date. Format YYYY-MM-DD.","title":"Created At Start"},"created_at_end":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only payment orders created on or before this date. Format YYYY-MM-DD.","title":"Created At End"},"reference_number":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only payment orders with this reference number.","title":"Reference Number"},"external_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only the payment order with this external id.","title":"External Id"}},"title":"list_payment_ordersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_payment_order":{"post":{"operationId":"get_payment_order","summary":"Get one payment order by id: status, type, direction, amount, dates, accounts, reconciliation status and failure reason.","description":"Get one payment order by id: status, type, direction, amount, dates, accounts, reconciliation status and failure reason. Use for \"Show Modern Treasury payment order 9fcb9a2e-4f2b-4c4d-9a1e-6f6f7b9a0001\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"id":{"description":"Payment order id (UUID).","maxLength":200,"title":"Id","type":"string"}},"required":["id"],"title":"get_payment_orderArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_internal_accounts":{"post":{"operationId":"list_internal_accounts","summary":"List your internal (own bank) accounts with name, type, currency, status, party name and creation time; account and rout","description":"List your internal (own bank) accounts with name, type, currency, status, party name and creation time; account and routing numbers are left out. Use for \"What internal accounts do I have in Modern Treasury\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"status":{"anyOf":[{"enum":["active","pending_activation","suspended","pending_closure","closed"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this status.","title":"Status"},"currency":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only this ISO 4217 currency code, for example USD.","title":"Currency"},"payment_type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only accounts that can originate this payment type, for example ach or wire.","title":"Payment Type"},"payment_direction":{"anyOf":[{"enum":["credit","debit"],"type":"string"},{"type":"null"}],"default":null,"description":"Only accounts that can originate this direction.","title":"Payment Direction"},"counterparty_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only accounts of this counterparty id.","title":"Counterparty Id"}},"title":"list_internal_accountsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_transactions":{"post":{"operationId":"list_transactions","summary":"List bank transactions imported from your accounts with amount in minor units, direction, date, type, description and re","description":"List bank transactions imported from your accounts with amount in minor units, direction, date, type, description and reconciliation flags. Use for \"What transactions posted on my Modern Treasury accounts this week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"internal_account_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions of this internal account id.","title":"Internal Account Id"},"direction":{"anyOf":[{"enum":["credit","debit"],"type":"string"},{"type":"null"}],"default":null,"description":"Only credits or debits.","title":"Direction"},"as_of_date_start":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions on or after this date. Format YYYY-MM-DD.","title":"As Of Date Start"},"as_of_date_end":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions on or before this date. Format YYYY-MM-DD.","title":"As Of Date End"},"posted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for posted transactions only, false for pending ones.","title":"Posted"},"description":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions whose description contains this text.","title":"Description"},"payment_type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only this payment type, for example ach, wire or check.","title":"Payment Type"},"counterparty_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only transactions of this counterparty id.","title":"Counterparty Id"}},"title":"list_transactionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_expected_payments":{"post":{"operationId":"list_expected_payments","summary":"List expected payments (incoming or outgoing amounts you await) with amount bounds, date bounds, status and reconciliati","description":"List expected payments (incoming or outgoing amounts you await) with amount bounds, date bounds, status and reconciliation amounts. Use for \"Which expected payments are still unreconciled in Modern Treasury\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"status":{"anyOf":[{"enum":["archived","partially_reconciled","reconciled","unreconciled"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this status.","title":"Status"},"direction":{"anyOf":[{"enum":["credit","debit"],"type":"string"},{"type":"null"}],"default":null,"description":"Only credits or debits.","title":"Direction"},"type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only this payment type, for example ach or wire.","title":"Type"},"internal_account_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only expected payments of this internal account id.","title":"Internal Account Id"},"counterparty_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only expected payments of this counterparty id.","title":"Counterparty Id"},"created_at_lower_bound":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only those created on or after this date. Format YYYY-MM-DD.","title":"Created At Lower Bound"},"created_at_upper_bound":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only those created on or before this date. Format YYYY-MM-DD.","title":"Created At Upper Bound"}},"title":"list_expected_paymentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_incoming_payment_details":{"post":{"operationId":"list_incoming_payment_details","summary":"List incoming payment details (credits received) with amount, type, status, date and reconciliation status; originating ","description":"List incoming payment details (credits received) with amount, type, status, date and reconciliation status; originating account numbers are left out. Use for \"What incoming payments arrived at Modern Treasury this week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"status":{"anyOf":[{"enum":["completed","pending","returned"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this status.","title":"Status"},"direction":{"anyOf":[{"enum":["credit","debit"],"type":"string"},{"type":"null"}],"default":null,"description":"Only credits or debits.","title":"Direction"},"type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only this payment type, for example ach, wire or rtp.","title":"Type"},"virtual_account_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only those received on this virtual account id.","title":"Virtual Account Id"},"as_of_date_start":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only those on or after this date. Format YYYY-MM-DD.","title":"As Of Date Start"},"as_of_date_end":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only those on or before this date. Format YYYY-MM-DD.","title":"As Of Date End"}},"title":"list_incoming_payment_detailsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_returns":{"post":{"operationId":"list_returns","summary":"List returns (reversed or rejected payments) with amount, code, reason, status, role and the returned payment. Use for \"","description":"List returns (reversed or rejected payments) with amount, code, reason, status, role and the returned payment. Use for \"Which payments were returned in Modern Treasury\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"internal_account_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only returns of this internal account id.","title":"Internal Account Id"},"counterparty_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only returns of this counterparty id.","title":"Counterparty Id"},"returnable_type":{"anyOf":[{"enum":["incoming_payment_detail","payment_order","return","reversal"],"type":"string"},{"type":"null"}],"default":null,"description":"Only returns of this kind of object.","title":"Returnable Type"},"returnable_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only returns of this object id.","title":"Returnable Id"}},"title":"list_returnsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_balance_reports":{"post":{"operationId":"list_balance_reports","summary":"List balance reports of one internal account (closing, opening, current or intraday balances) with date, time and balanc","description":"List balance reports of one internal account (closing, opening, current or intraday balances) with date, time and balance lines. Use for \"What was the closing balance of Modern Treasury internal account 0e3f4a1c-2b7d-4c9e-8f10-5a6b7c8d9e01 yesterday\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"internal_account_id":{"description":"Internal account id (UUID).","maxLength":200,"title":"Internal Account Id","type":"string"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"as_of_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only the balance report of this date. Format YYYY-MM-DD.","title":"As Of Date"},"balance_report_type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only this report type, for example intraday, previous_day, real_time or other.","title":"Balance Report Type"}},"required":["internal_account_id"],"title":"list_balance_reportsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_invoices":{"post":{"operationId":"list_invoices","summary":"List invoices with number, status, total, amount paid and remaining in minor units, currency, due date, recipient and ho","description":"List invoices with number, status, total, amount paid and remaining in minor units, currency, due date, recipient and hosted URL. Use for \"Which Modern Treasury invoices are unpaid and overdue\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"status":{"anyOf":[{"enum":["draft","paid","partially_paid","payment_pending","unpaid","voided"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this status.","title":"Status"},"counterparty_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only invoices of this counterparty id.","title":"Counterparty Id"},"number":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only the invoice with this number.","title":"Number"},"due_date_start":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only invoices due on or after this date. Format YYYY-MM-DD.","title":"Due Date Start"},"due_date_end":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only invoices due on or before this date. Format YYYY-MM-DD.","title":"Due Date End"},"created_at_start":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only invoices created on or after this date. Format YYYY-MM-DD.","title":"Created At Start"},"created_at_end":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only invoices created on or before this date. Format YYYY-MM-DD.","title":"Created At End"}},"title":"list_invoicesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_events":{"post":{"operationId":"list_events","summary":"List account events with resource type, event name, entity id and event time. Use for \"What Modern Treasury events happe","description":"List account events with resource type, event name, entity id and event time. Use for \"What Modern Treasury events happened on payment orders today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":25,"description":"How many records to return (default 25).","title":"Per Page"},"after_cursor":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Cursor for the next page. The provider returns it in a response header that this connector does not pass on, so narrow by date or filters instead of paging.","title":"After Cursor"},"resource":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only events of this resource type.","title":"Resource"},"event_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only events with this name.","title":"Event Name"},"entity_id":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only events of this entity id.","title":"Entity Id"},"event_time_start":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only events at or after this ISO 8601 time.","title":"Event Time Start"},"event_time_end":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Only events at or before this ISO 8601 time.","title":"Event Time End"}},"title":"list_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}