Servers Playground How we check Add a server Log in

Foxy.io MCP by usefulapi

Working · 2.4 s

io.usefulapi/foxyiov1.20.0 Domain verified

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

Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://foxyio.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

foxy_get_api_home Read-only

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

This tool takes no arguments.

Foxy.io MCP by usefulapi MCP server | mcptry

Tools (14)

foxy_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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

foxy_get_customer

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

read-only

Argument	Type	Description
id*	any	Customer id.
zoom	string	Comma-separated related resources to embed.

Input schema (JSON)

{
  "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

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

foxy_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

Argument	Type	Description
store_id*	any	Store id (get it from foxy_get_default_store).

Input schema (JSON)

{
  "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 a single subscription by id, optionally zooming related resources. Foxy hAPI: GET /subscriptions/{id}.

read-only

Argument	Type	Description
id*	any	Subscription id.
zoom	string	Comma-separated related resources to embed, e.g. 'transaction_template,original_transaction'.

Input schema (JSON)

{
  "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 a single transaction by id, optionally zooming related resources (items, customer, payments, applied_taxes…). Foxy hAPI: GET /transactions/{id}.

read-only

Argument	Type	Description
id*	any	Transaction id.
zoom	string	Comma-separated related resources to embed, e.g. 'items,customer'.

Input schema (JSON)

{
  "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 a store's carts (in-progress / abandoned checkouts). Returns a HAL collection embedding fx:carts. Foxy hAPI: GET /stores/{store_id}/carts.

read-only

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

Input schema (JSON)

{
  "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 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

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

Input schema (JSON)

{
  "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 a store's customers. Returns a HAL collection embedding fx:customers. Foxy hAPI: GET /stores/{store_id}/customers.

read-only

Argument	Type	Description
email	string	Filter by exact customer email.
limit	integer	Max results per page (Foxy default 20).
offset	integer	Pagination offset.
store_id	any	Store id. If omitted, the default store (fx:store) is used.

Input schema (JSON)

{
  "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 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

Argument	Type	Description
zoom	string	Comma-separated related resources to embed, e.g. 'item_options'.
limit	integer	Max results per page (Foxy default 20).
offset	integer	Pagination offset.
transaction_id*	any	Transaction id whose line items to list.

Input schema (JSON)

{
  "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 a store's subscriptions (recurring orders). Returns a HAL collection embedding fx:subscriptions. Foxy hAPI: GET /stores/{store_id}/subscriptions.

read-only

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

Input schema (JSON)

{
  "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 a store's transactions (orders), newest first. Returns a HAL collection embedding fx:transactions. Foxy hAPI: GET /stores/{store_id}/transactions.

read-only

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

Input schema (JSON)

{
  "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

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

Argument	Type	Description
id*	any	Customer id to update.
email	string	New email address.
last_name	string	New last name.
first_name	string	New first name.

Input schema (JSON)

{
  "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

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

Argument	Type	Description
id*	any	Subscription id to update.
frequency	string	Billing frequency, e.g. '1m' (monthly), '2w' (2 weeks), '1y' (yearly).
is_active	boolean	Set true to activate or false to pause the subscription.
next_transaction_date	string	Next run date, YYYY-MM-DD (reschedules the subscription).

Input schema (JSON)

{
  "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)."
    }
  }
}