Foxy.io MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.5Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server for Foxy.io stores: read orders, subscriptions, customers, carts and coupons, and update customers and subscriptions.

What you can do
  • Discover the API home and resolve the default store, then read store settings
  • List and inspect transactions (orders) and their line items
  • List and inspect subscriptions, including related resources
  • List and inspect customers, carts and coupons
  • Update customer profile fields and change subscription schedule, frequency or active state
When to use it
Useful when you want an assistant to answer questions about a Foxy.io store — recent orders, active subscribers, abandoned carts, coupon rules — or to make small, targeted changes to customer records and subscriptions without opening the Foxy admin.
Requirements
Remote endpoint reached over streamable HTTP; no local install. Sign-in is via OAuth, and the login page asks for a Foxy Client ID, Client Secret and Refresh Token from the Foxy admin (Integrations, Get Token). Credentials are stored per user. A free plan allows 50 tool calls per month; paid plans raise the limit.
Before you install
The server receives your Foxy Client ID, Client Secret and Refresh Token, which grant access to live store data. Two tools modify live store data: customer profile updates and subscription changes that affect future billing. Paid plans are billed through a payment link, and cancellation runs to the end of the paid period with no refund for the current period.

Installation

In SourceWeft

  1. Open Foxy.io MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Ffoxyio/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "foxy-io-by-usefulapi": {
      "type": "http",
      "url": "https://foxyio.usefulapi.io/mcp"
    }
  }
}

README

Foxy.io MCP by usefulapi

Manage Foxy.io from Claude, Cursor, or any MCP client — read transactions, subscriptions, customers, carts and coupons, and update customers and subscriptions. Hosted, no local install: connect with your Foxy API credentials.

Live endpoint: https://foxyio.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://foxyio.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http foxyio https://foxyio.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "foxyio": {      "url": "https://foxyio.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Foxy.io credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/foxyio/

On first connect you'll provide your Foxy Client ID, Client Secret, and Refresh Token (Foxy admin → Integrations → "Get Token"). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
foxy_get_api_homereadGet API home
foxy_get_default_storereadGet default store
foxy_get_storereadGet store
foxy_list_transactionsreadList transactions
foxy_get_transactionreadGet transaction
foxy_list_subscriptionsreadList subscriptions
foxy_get_subscriptionreadGet subscription
foxy_list_customersreadList customers
foxy_get_customerreadGet customer
foxy_list_cartsreadList carts
foxy_list_couponsreadList coupons
foxy_list_itemsreadList transaction items
foxy_update_customerwriteUpdate customer
foxy_update_subscriptionwriteUpdate subscription
foxy_usage_statusmetaUsage status (free-tier meter)
foxy_request_featuremetaRequest a missing feature
foxy_upgrademetaUpgrade to Pro or Pro+
foxy_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with foxy_upgrade (it returns a Stripe Checkout link). Cancel any time with foxy_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running foxy_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/foxyio/README.md at commit 4046075

Tools

14

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 /.

Takes no parameters.

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.

Takes no parameters.

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}.

Parametersstore_idrequired

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.

Parameterszoomlimitorderoffsetis_teststore_idcustomer_email

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}.

Parametersidrequiredzoom

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.

Parameterszoomlimitoffsetstore_idis_active

foxy_get_subscription

Get subscription

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

Parametersidrequiredzoom

foxy_list_customers

List customers

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

Parametersemaillimitoffsetstore_id

foxy_get_customer

Get customer

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

Parametersidrequiredzoom

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.

Parameterszoomlimitoffsetstore_id

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.

Parameterszoomlimitoffsetstore_id

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.

Parameterszoomlimitoffsettransaction_idrequired

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.

Parametersidrequiredemaillast_namefirst_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.

Parametersidrequiredfrequencyis_activenext_transaction_date

Version history

22
  1. v1.36.5LatestNov 8, 2026
  2. v1.36.4Nov 7, 2026
  3. v1.35.3Nov 5, 2026
  4. v1.35.2Nov 5, 2026
  5. v1.35.1Nov 4, 2026
  6. v1.35.0Nov 3, 2026
  7. v1.34.1Nov 3, 2026
  8. v1.33.0Nov 1, 2026
  9. v1.31.0Oct 31, 2026
  10. v1.30.0Oct 31, 2026
  11. v1.29.2Oct 30, 2026
  12. v1.29.0Oct 30, 2026
  13. v1.24.0Oct 26, 2026
  14. v1.21.3Oct 25, 2026
  15. v1.21.0Oct 25, 2026
  16. v1.20.0Oct 24, 2026
  17. v1.17.0Oct 23, 2026
  18. v1.16.4Oct 22, 2026
  19. v1.16.3Oct 21, 2026
  20. v1.11.1Oct 9, 2026
  21. v1.10.0Oct 9, 2026
  22. v1.0.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations