# Foxy.io MCP by usefulapi

> Foxy.io MCP by usefulapi is an MCP server. Read Foxy transactions, subscriptions, customers, carts and coupons; update customers and subs. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/foxyio/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/foxyio
- **MCP Registry name:** io.usefulapi/foxyio
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http foxyio https://foxyio.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://foxyio.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "foxyio": {
      "url": "https://foxyio.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "foxyio": {
      "type": "http",
      "url": "https://foxyio.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "foxyio": {
      "serverUrl": "https://foxyio.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "foxyio": {
      "type": "http",
      "url": "https://foxyio.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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 /.
- `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.
- `foxy_get_store`: Get a single store resource by id, including its settings and _links to sub-collections. Foxy hAPI: GET /stores/{store_id}.
- `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.
- `foxy_get_transaction`: Get a single transaction by id, optionally zooming related resources (items, customer, payments, applied_taxes…). Foxy hAPI: GET /transactions/{id}.
- `foxy_list_subscriptions`: List a store's subscriptions (recurring orders). Returns a HAL collection embedding fx:subscriptions. Foxy hAPI: GET /stores/{store_id}/subscriptions.
- `foxy_get_subscription`: Get a single subscription by id, optionally zooming related resources. Foxy hAPI: GET /subscriptions/{id}.
- `foxy_list_customers`: List a store's customers. Returns a HAL collection embedding fx:customers. Foxy hAPI: GET /stores/{store_id}/customers.
- `foxy_get_customer`: Get a single customer by id, optionally zooming related resources (default_billing_address, subscriptions…). Foxy hAPI: GET /customers/{id}.
- `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.
- `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.
- `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.
- `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.
- `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.

## FAQ

### How do I add Foxy.io MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http foxyio https://foxyio.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/foxy-io-mcp-by-usefulapi
