MCP Server

foxyio

io.usefulapi/foxyio
Commerce & Retail Payments & Fintech Public & reachable MCP 2026-07-28

What this MCP does

Reads Foxy commerce stores, customers, transactions, carts, subscriptions, coupons, and items, and updates customer and subscription data.

foxy_get_api_home
Get API home
Get the Foxy hAPI home document — its _links / rels (including fx:store for the authenticated default store). Useful for HAL discovery. Foxy hAPI: GET /.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
foxy_get_customer
Get customer
Get a single customer by id, optionally zooming related resources (default_billing_address, subscriptions…). Foxy hAPI: GET /customers/{id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Customer id.'}, 'zoom': {'type': 'string', 'description': 'Comma-separated related resources to embed.'}}}
foxy_get_default_store
Get default store
Resolve and return the authenticated user's default store (and its id) by fetching the API home and following the fx:store link. Use this to discover the store_id the list tools accept. Foxy hAPI: GET / then GET fx:store.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
foxy_get_store
Get store
Get a single store resource by id, including its settings and _links to sub-collections. Foxy hAPI: GET /stores/{store_id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['store_id'], 'properties': {'store_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Store id (get it from foxy_get_default_store).'}}}
foxy_get_subscription
Get subscription
Get a single subscription by id, optionally zooming related resources. Foxy hAPI: GET /subscriptions/{id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Subscription id.'}, 'zoom': {'type': 'string', 'description': "Comma-separated related resources to embed, e.g. 'transaction_template,original_transaction'."}}}
foxy_get_transaction
Get transaction
Get a single transaction by id, optionally zooming related resources (items, customer, payments, applied_taxes…). Foxy hAPI: GET /transactions/{id}.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Transaction id.'}, 'zoom': {'type': 'string', 'description': "Comma-separated related resources to embed, e.g. 'items,customer'."}}}
foxy_list_carts
List carts
List a store's carts (in-progress / abandoned checkouts). Returns a HAL collection embedding fx:carts. Foxy hAPI: GET /stores/{store_id}/carts.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'zoom': {'type': 'string', 'description': "Comma-separated related resources to embed, e.g. 'items,customer'."}, 'limit': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Max results per page (Foxy default 20).'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'store_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Store id. If omitted, the default store (fx:store) is used.'}}}
foxy_list_coupons
List coupons
List a store's coupons (discount codes and their rules). Returns a HAL collection embedding fx:coupons. Foxy hAPI: GET /stores/{store_id}/coupons.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'zoom': {'type': 'string', 'description': "Comma-separated related resources to embed, e.g. 'coupon_codes'."}, 'limit': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Max results per page (Foxy default 20).'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'store_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Store id. If omitted, the default store (fx:store) is used.'}}}
foxy_list_customers
List customers
List a store's customers. Returns a HAL collection embedding fx:customers. Foxy hAPI: GET /stores/{store_id}/customers.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'email': {'type': 'string', 'description': 'Filter by exact customer email.'}, 'limit': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Max results per page (Foxy default 20).'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'store_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Store id. If omitted, the default store (fx:store) is used.'}}}
foxy_list_items
List transaction items
List the line items of a transaction (the products purchased). Returns a HAL collection embedding fx:items. Foxy hAPI: GET /transactions/{transaction_id}/items.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['transaction_id'], 'properties': {'zoom': {'type': 'string', 'description': "Comma-separated related resources to embed, e.g. 'item_options'."}, 'limit': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Max results per page (Foxy default 20).'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'transaction_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Transaction id whose line items to list.'}}}
foxy_list_subscriptions
List subscriptions
List a store's subscriptions (recurring orders). Returns a HAL collection embedding fx:subscriptions. Foxy hAPI: GET /stores/{store_id}/subscriptions.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'zoom': {'type': 'string', 'description': "Comma-separated related resources to embed, e.g. 'transaction_template,last_transaction'."}, 'limit': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Max results per page (Foxy default 20).'}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'store_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Store id. If omitted, the default store (fx:store) is used.'}, 'is_active': {'type': 'boolean', 'description': 'Filter to active (true) or inactive (false) subscriptions.'}}}
foxy_list_transactions
List transactions
List a store's transactions (orders), newest first. Returns a HAL collection embedding fx:transactions. Foxy hAPI: GET /stores/{store_id}/transactions.
Read only
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'zoom': {'type': 'string', 'description': "Comma-separated related resources to embed, e.g. 'items,customer,payments'."}, 'limit': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Max results per page (Foxy default 20).'}, 'order': {'type': 'string', 'description': "Sort expression, e.g. 'transaction_date desc'."}, 'offset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Pagination offset.'}, 'is_test': {'type': 'boolean', 'description': 'Filter to test (true) or live (false) transactions.'}, 'store_id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Store id. If omitted, the default store (fx:store) is used.'}, 'customer_email': {'type': 'string', 'description': "Filter by the transaction's customer email."}}}
foxy_update_customer
Update customer
UPDATES a customer's profile fields (first_name, last_name, email). This MODIFIES live store data. Foxy hAPI: PATCH /customers/{id}. Provide only the fields you want to change.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Customer id to update.'}, 'email': {'type': 'string', 'description': 'New email address.'}, 'last_name': {'type': 'string', 'description': 'New last name.'}, 'first_name': {'type': 'string', 'description': 'New first name.'}}}
foxy_update_subscription
Update subscription
UPDATES a subscription — reschedule its next run (next_transaction_date), change its frequency, or activate/pause it (is_active). This MODIFIES live store data and affects future billing. Foxy hAPI: PATCH /subscriptions/{id}. Provide only the fields you want to change.
Destructive
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, {'type': 'string'}], 'description': 'Subscription id to update.'}, 'frequency': {'type': 'string', 'description': "Billing frequency, e.g. '1m' (monthly), '2w' (2 weeks), '1y' (yearly)."}, 'is_active': {'type': 'boolean', 'description': 'Set true to activate or false to pause the subscription.'}, 'next_transaction_date': {'type': 'string', 'description': 'Next run date, YYYY-MM-DD (reschedules the subscription).'}}}
Changed
foxy_update_subscription
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_update_customer
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_list_items
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_list_coupons
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_list_carts
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_get_customer
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_list_customers
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_get_subscription
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_list_subscriptions
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_get_transaction
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_list_transactions
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_get_store
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_get_default_store
Oct. 1, 2026, 2:50 a.m.
Changed
foxy_get_api_home
Oct. 1, 2026, 2:50 a.m.
Added
foxy_update_subscription
Sept. 17, 2026, 12:53 p.m.
Added
foxy_update_customer
Sept. 17, 2026, 12:53 p.m.
Added
foxy_list_items
Sept. 17, 2026, 12:53 p.m.
Added
foxy_list_coupons
Sept. 17, 2026, 12:53 p.m.
Added
foxy_list_carts
Sept. 17, 2026, 12:53 p.m.
Added
foxy_get_customer
Sept. 17, 2026, 12:53 p.m.
Added
foxy_list_customers
Sept. 17, 2026, 12:53 p.m.
Added
foxy_get_subscription
Sept. 17, 2026, 12:53 p.m.
Added
foxy_list_subscriptions
Sept. 17, 2026, 12:53 p.m.
Added
foxy_get_transaction
Sept. 17, 2026, 12:53 p.m.
Added
foxy_list_transactions
Sept. 17, 2026, 12:53 p.m.
Added
foxy_get_store
Sept. 17, 2026, 12:53 p.m.
Added
foxy_get_default_store
Sept. 17, 2026, 12:53 p.m.
Added
foxy_get_api_home
Sept. 17, 2026, 12:53 p.m.