Serveur MCP

foxyio

io.usefulapi/foxyio
Commerce et retail Paiements et fintech Public et accessible MCP 2026-07-28

Ce que fait ce MCP

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 /.
Lecture seule
Schéma d’entrée
{'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}.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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}.
Lecture seule
Schéma d’entrée
{'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}.
Lecture seule
Schéma d’entrée
{'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}.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Lecture seule
Schéma d’entrée
{'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.
Destructif
Schéma d’entrée
{'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.
Destructif
Schéma d’entrée
{'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).'}}}
Modifié
foxy_update_subscription
1 October 2026 02:50
Modifié
foxy_update_customer
1 October 2026 02:50
Modifié
foxy_list_items
1 October 2026 02:50
Modifié
foxy_list_coupons
1 October 2026 02:50
Modifié
foxy_list_carts
1 October 2026 02:50
Modifié
foxy_get_customer
1 October 2026 02:50
Modifié
foxy_list_customers
1 October 2026 02:50
Modifié
foxy_get_subscription
1 October 2026 02:50
Modifié
foxy_list_subscriptions
1 October 2026 02:50
Modifié
foxy_get_transaction
1 October 2026 02:50
Modifié
foxy_list_transactions
1 October 2026 02:50
Modifié
foxy_get_store
1 October 2026 02:50
Modifié
foxy_get_default_store
1 October 2026 02:50
Modifié
foxy_get_api_home
1 October 2026 02:50
Ajouté
foxy_update_subscription
17 September 2026 12:53
Ajouté
foxy_update_customer
17 September 2026 12:53
Ajouté
foxy_list_items
17 September 2026 12:53
Ajouté
foxy_list_coupons
17 September 2026 12:53
Ajouté
foxy_list_carts
17 September 2026 12:53
Ajouté
foxy_get_customer
17 September 2026 12:53
Ajouté
foxy_list_customers
17 September 2026 12:53
Ajouté
foxy_get_subscription
17 September 2026 12:53
Ajouté
foxy_list_subscriptions
17 September 2026 12:53
Ajouté
foxy_get_transaction
17 September 2026 12:53
Ajouté
foxy_list_transactions
17 September 2026 12:53
Ajouté
foxy_get_store
17 September 2026 12:53
Ajouté
foxy_get_default_store
17 September 2026 12:53
Ajouté
foxy_get_api_home
17 September 2026 12:53