{"openapi":"3.1.0","info":{"title":"MoneyHash (BYOK) API","version":"0.1.0","description":"MoneyHash (BYOK) lets an AI assistant read your own MoneyHash data through the MoneyHash API with a key you supply (MoneyHash API key). Read-only: 11 tools (list_accounts, list_account_transactions, get_transaction, get_payment_intent, list_intent_transactions, list_subscription_plans, list_plan_groups, list_subscriptions, list_settlement_operations, list_bulk_payout_requests, get_payment_link)....\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-moneyhash.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-moneyhash/docs"},"termsOfService":"https://connectorbay.com/byok-moneyhash/terms"},"servers":[{"url":"https://byok-moneyhash.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-moneyhash/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_accounts":{"post":{"operationId":"list_accounts","summary":"List the payment accounts of your MoneyHash organization with the payment methods enabled on each. Use for \"Which MoneyH","description":"List the payment accounts of your MoneyHash organization with the payment methods enabled on each. Use for \"Which MoneyHash accounts does my organization have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (provider default applies when omitted).","title":"Limit"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result to return, for paging.","title":"Offset"}},"title":"list_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_account_transactions":{"post":{"operationId":"list_account_transactions","summary":"List the transactions of one MoneyHash account with status, amount, currency, payment method and provider. Customer bill","description":"List the transactions of one MoneyHash account with status, amount, currency, payment method and provider. Customer billing data is not returned. Use for \"What are the latest transactions on my MoneyHash account\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"account_id":{"description":"Id of the MoneyHash account, from list_accounts.","maxLength":200,"title":"Account Id","type":"string"},"search":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Optional search term to filter transactions.","title":"Search"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (provider default applies when omitted).","title":"Limit"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result to return, for paging.","title":"Offset"}},"required":["account_id"],"title":"list_account_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/get_transaction":{"post":{"operationId":"get_transaction","summary":"Get one MoneyHash transaction by its UUID: status, amount, currency, payment method, provider and timestamps. Customer b","description":"Get one MoneyHash transaction by its UUID: status, amount, currency, payment method, provider and timestamps. Customer billing data is not returned. Use for \"What is the status of MoneyHash transaction 3f2a1b0c\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"trx_uuid":{"description":"UUID of the transaction.","maxLength":200,"title":"Trx Uuid","type":"string"}},"required":["trx_uuid"],"title":"get_transactionArguments","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_intent":{"post":{"operationId":"get_payment_intent","summary":"Get one payment intent: status, amount, currency, type, merchant reference, state and creation time. Customer and billin","description":"Get one payment intent: status, amount, currency, type, merchant reference, state and creation time. Customer and billing details are not returned. Use for \"What is the state of MoneyHash payment intent abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"intent_id":{"description":"Id of the payment intent.","maxLength":200,"title":"Intent Id","type":"string"}},"required":["intent_id"],"title":"get_payment_intentArguments","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_intent_transactions":{"post":{"operationId":"list_intent_transactions","summary":"List the transaction attempts made against one payment intent, with status, amount, method and provider. Use for \"Which ","description":"List the transaction attempts made against one payment intent, with status, amount, method and provider. Use for \"Which transaction attempts were made for MoneyHash intent abc123\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"intent_id":{"description":"Id of the payment intent.","maxLength":200,"title":"Intent Id","type":"string"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (provider default applies when omitted).","title":"Limit"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result to return, for paging.","title":"Offset"}},"required":["intent_id"],"title":"list_intent_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_subscription_plans":{"post":{"operationId":"list_subscription_plans","summary":"List the subscription plans you created: price, currency, billing interval, trial period, fees and discounts. Use for \"W","description":"List the subscription plans you created: price, currency, billing interval, trial period, fees and discounts. Use for \"What subscription plans do I have on MoneyHash\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (provider default applies when omitted).","title":"Limit"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result to return, for paging.","title":"Offset"}},"title":"list_subscription_plansArguments","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_plan_groups":{"post":{"operationId":"list_plan_groups","summary":"List subscription plan groups with currency, automatic-charge flag and number of plans, optionally including the plans. ","description":"List subscription plan groups with currency, automatic-charge flag and number of plans, optionally including the plans. Use for \"What subscription plan groups are set up on MoneyHash\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"currency":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Only plan groups in this currency code, for example EGP.","title":"Currency"},"include_plans":{"anyOf":[{"enum":["true","false"],"type":"string"},{"type":"null"}],"default":"false","description":"Whether to include the plans of each group: true or false.","title":"Include Plans"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (provider default applies when omitted).","title":"Limit"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result to return, for paging.","title":"Offset"}},"title":"list_plan_groupsArguments","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_subscriptions":{"post":{"operationId":"list_subscriptions","summary":"List subscriptions with status, start and end dates and remaining cycles. Customer details are not returned. Use for \"Ho","description":"List subscriptions with status, start and end dates and remaining cycles. Customer details are not returned. Use for \"How many active MoneyHash subscriptions do I have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"custom_fields_name":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Optional custom field name to filter by (use with custom_fields_value).","title":"Custom Fields Name"},"custom_fields_value":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Optional custom field value to match.","title":"Custom Fields Value"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (provider default applies when omitted).","title":"Limit"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result to return, for paging.","title":"Offset"}},"title":"list_subscriptionsArguments","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_settlement_operations":{"post":{"operationId":"list_settlement_operations","summary":"List settlement and reconciliation operations: provider gross amount, fees, tax, net settled amount, settlement and reco","description":"List settlement and reconciliation operations: provider gross amount, fees, tax, net settled amount, settlement and reconciliation status. Use for \"Which MoneyHash operations are still unsettled, and what fees did providers charge\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"settlement_status":{"anyOf":[{"enum":["SETTLED","UNSETTLED"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter by settlement status: SETTLED or UNSETTLED.","title":"Settlement Status"},"reconciliation_status":{"anyOf":[{"enum":["MATCHED","MIS_MATCHED"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter by reconciliation status: MATCHED or MIS_MATCHED.","title":"Reconciliation Status"},"start_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only operations created on or after this ISO 8601 time, for example 2026-01-01T00:00:00Z.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only operations created on or before this ISO 8601 time.","title":"End Date"},"settlement_currency":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by settlement currency code, for example USD.","title":"Settlement Currency"},"account_id":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Only operations of this account id.","title":"Account Id"},"is_live":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for live mode operations, false for test mode.","title":"Is Live"},"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (provider default applies when omitted).","title":"Limit"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result to return, for paging.","title":"Offset"}},"title":"list_settlement_operationsArguments","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_bulk_payout_requests":{"post":{"operationId":"list_bulk_payout_requests","summary":"List bulk payout requests with status and counts of items in each processing state. Use for \"What is the status of my Mo","description":"List bulk payout requests with status and counts of items in each processing state. Use for \"What is the status of my MoneyHash bulk payout batches\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"limit":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (provider default applies when omitted).","title":"Limit"},"offset":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Index of the first result to return, for paging.","title":"Offset"}},"title":"list_bulk_payout_requestsArguments","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_link":{"post":{"operationId":"get_payment_link","summary":"Get a payment link by id: name, status, URL, currency, quantity type and totals. Use for \"Is MoneyHash payment link pl_a","description":"Get a payment link by id: name, status, URL, currency, quantity type and totals. Use for \"Is MoneyHash payment link pl_abc paid\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"payment_link_id":{"description":"Id of the payment link.","maxLength":200,"title":"Payment Link Id","type":"string"}},"required":["payment_link_id"],"title":"get_payment_linkArguments","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}}}}