Foxy.io MCP by usefulapi

Server Details

Read Foxy transactions, subscriptions, customers, carts and coupons; update customers and subs.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.

Status: Healthy
Uptime: 73.0% over 58 days
Last Tested: 2026-10-14 02:37
Transport: Streamable HTTP · MCP 2025-06-18
URL
Repository: m190/usefulapi-mcp
GitHub Stars: 0

TDQS

A4.1/5.0

Scored 2026-08-31 01:45 across 14 tools

Disambiguation5/5

Each tool targets a distinct resource and action: get/list/update are clearly separated per entity (customer, subscription, transaction, etc.). The helper tools like get_default_store and get_api_home serve unique discovery purposes, and there is no overlap in their use cases.

Naming Consistency5/5

All 14 tools follow the identical pattern 'foxy_<verb>_<noun>' with verbs limited to get, list, and update. The naming is uniform, predictable, and descriptive, making it easy to infer functionality from the name alone.

Tool Count5/5

With 14 tools, the server covers a meaningful set of operations across the Foxy hAPI resources without overwhelming bloat. The count is within the ideal 3–15 range and each tool serves a clear purpose in the e-commerce domain.

Completeness3/5

The server provides robust read coverage (list/get) for most major resources (customers, subscriptions, transactions, stores, carts, coupons, items) but lacks any create or delete operations. Only customers and subscriptions support updates, leaving notable gaps for a full lifecycle (e.g., no way to create a customer or update a transaction). This is a meaningful but not severe incompleteness.

Available Tools

14 tools

foxy_get_api_homeGet API home

Read-only

Inspect

Get the Foxy hAPI home document — its _links / rels (including fx:store for the authenticated default store). Useful for HAL discovery. Foxy hAPI: GET /.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

foxy_get_customerGet customer

Read-only

Inspect

Get a single customer by id, optionally zooming related resources (default_billing_address, subscriptions…). Foxy hAPI: GET /customers/{id}.

ParametersJSON Schema

Name	Required	Description	Default
`id`	Yes	Customer id.
`zoom`	No	Comma-separated related resources to embed.

foxy_get_default_storeGet default store

Read-only

Inspect

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.

ParametersJSON Schema

Name	Required	Description	Default
No parameters

foxy_get_storeGet store

Read-only

Inspect

Get a single store resource by id, including its settings and _links to sub-collections. Foxy hAPI: GET /stores/{store_id}.

ParametersJSON Schema

Name	Required	Description	Default
`store_id`	Yes	Store id (get it from foxy_get_default_store).

foxy_get_subscriptionGet subscription

Read-only

Inspect

Get a single subscription by id, optionally zooming related resources. Foxy hAPI: GET /subscriptions/{id}.

ParametersJSON Schema

Name	Required	Description	Default
`id`	Yes	Subscription id.
`zoom`	No	Comma-separated related resources to embed, e.g. 'transaction_template,original_transaction'.

foxy_get_transactionGet transaction

Read-only

Inspect

Get a single transaction by id, optionally zooming related resources (items, customer, payments, applied_taxes…). Foxy hAPI: GET /transactions/{id}.

ParametersJSON Schema

Name	Required	Description	Default
`id`	Yes	Transaction id.
`zoom`	No	Comma-separated related resources to embed, e.g. 'items,customer'.

foxy_list_cartsList carts

Read-only

Inspect

List a store's carts (in-progress / abandoned checkouts). Returns a HAL collection embedding fx:carts. Foxy hAPI: GET /stores/{store_id}/carts.

ParametersJSON Schema

Name	Required	Description
`zoom`	No	Comma-separated related resources to embed, e.g. 'items,customer'.
`limit`	No	Max results per page (Foxy default 20).
`offset`	No	Pagination offset.
`store_id`	No	Store id. If omitted, the default store (fx:store) is used.

foxy_list_couponsList coupons

Read-only

Inspect

List a store's coupons (discount codes and their rules). Returns a HAL collection embedding fx:coupons. Foxy hAPI: GET /stores/{store_id}/coupons.

ParametersJSON Schema

Name	Required	Description
`zoom`	No	Comma-separated related resources to embed, e.g. 'coupon_codes'.
`limit`	No	Max results per page (Foxy default 20).
`offset`	No	Pagination offset.
`store_id`	No	Store id. If omitted, the default store (fx:store) is used.

foxy_list_customersList customers

Read-only

Inspect

List a store's customers. Returns a HAL collection embedding fx:customers. Foxy hAPI: GET /stores/{store_id}/customers.

ParametersJSON Schema

Name	Required	Description
`email`	No	Filter by exact customer email.
`limit`	No	Max results per page (Foxy default 20).
`offset`	No	Pagination offset.
`store_id`	No	Store id. If omitted, the default store (fx:store) is used.

foxy_list_itemsList transaction items

Read-only

Inspect

List the line items of a transaction (the products purchased). Returns a HAL collection embedding fx:items. Foxy hAPI: GET /transactions/{transaction_id}/items.

ParametersJSON Schema

Name	Required	Description
`zoom`	No	Comma-separated related resources to embed, e.g. 'item_options'.
`limit`	No	Max results per page (Foxy default 20).
`offset`	No	Pagination offset.
`transaction_id`	Yes	Transaction id whose line items to list.

foxy_list_subscriptionsList subscriptions

Read-only

Inspect

List a store's subscriptions (recurring orders). Returns a HAL collection embedding fx:subscriptions. Foxy hAPI: GET /stores/{store_id}/subscriptions.

ParametersJSON Schema

Name	Required	Description
`zoom`	No	Comma-separated related resources to embed, e.g. 'transaction_template,last_transaction'.
`limit`	No	Max results per page (Foxy default 20).
`offset`	No	Pagination offset.
`store_id`	No	Store id. If omitted, the default store (fx:store) is used.
`is_active`	No	Filter to active (true) or inactive (false) subscriptions.

foxy_list_transactionsList transactions

Read-only

Inspect

List a store's transactions (orders), newest first. Returns a HAL collection embedding fx:transactions. Foxy hAPI: GET /stores/{store_id}/transactions.

ParametersJSON Schema

Name	Required	Description
`zoom`	No	Comma-separated related resources to embed, e.g. 'items,customer,payments'.
`limit`	No	Max results per page (Foxy default 20).
`order`	No	Sort expression, e.g. 'transaction_date desc'.
`offset`	No	Pagination offset.
`is_test`	No	Filter to test (true) or live (false) transactions.
`store_id`	No	Store id. If omitted, the default store (fx:store) is used.
`customer_email`	No	Filter by the transaction's customer email.

foxy_update_customerUpdate customer

Destructive

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`id`	Yes	Customer id to update.
`email`	No	New email address.
`last_name`	No	New last name.
`first_name`	No	New first name.

foxy_update_subscriptionUpdate subscription

Destructive

Inspect

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.

ParametersJSON Schema

Name	Required	Description
`id`	Yes	Subscription id to update.
`frequency`	No	Billing frequency, e.g. '1m' (monthly), '2w' (2 weeks), '1y' (yearly).
`is_active`	No	Set true to activate or false to pause the subscription.
`next_transaction_date`	No	Next run date, YYYY-MM-DD (reschedules the subscription).