GoFlow MCP

A hosted Model Context Protocol server for the GoFlow API. Add it to Claude or Codex and ask about your orders, products and inventory in plain language. It covers all 104 documented GoFlow operations across 68 paths (spec v1, 45 tag groups).

POST https://goflow-mcp.u.jpapps.net/mcp

What you need

Your own GoFlow subdomain (the acme in acme.api.goflow.com) and a GoFlow API token. You pass them on every request; we never store them.

Claude

  1. Settings → Connectors → Add custom connector.
  2. URL: https://goflow-mcp.u.jpapps.net/mcp
  3. Under Request headers, add: Authorization: Bearer YOUR_GOFLOW_TOKEN and X-Goflow-Subdomain: YOUR_SUBDOMAIN.

For Claude Code, add it to .mcp.json instead:

{
  "mcpServers": {
    "goflow": {
      "type": "http",
      "url": "https://goflow-mcp.u.jpapps.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GOFLOW_TOKEN",
        "X-Goflow-Subdomain": "YOUR_SUBDOMAIN"
      }
    }
  }
}

Codex

# ~/.codex/config.toml
[mcp_servers.goflow]
url = "https://goflow-mcp.u.jpapps.net/mcp"
bearer_token = "YOUR_GOFLOW_TOKEN"
http_headers = { "X-Goflow-Subdomain" = "YOUR_SUBDOMAIN" }

Check it works

curl -X POST https://goflow-mcp.u.jpapps.net/mcp \
  -H "Authorization: Bearer YOUR_GOFLOW_TOKEN" \
  -H "X-Goflow-Subdomain: YOUR_SUBDOMAIN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

Rather than one tool per endpoint, three generic tools read the OpenAPI spec at runtime, so the whole API stays reachable. The usual path for anything without a dedicated tool is search → describe → request.

goflow_search_endpointsFind endpoints by keyword
goflow_describe_endpointParameters, filters, body/response schema, rate limit
goflow_requestCall any endpoint in the spec
goflow_list_orders / goflow_get_orderOrders, normalized
goflow_cancel_order / goflow_split_orderOrder mutations
goflow_submit_shipment_feed / goflow_get_shipment_feed_statusShip-confirm
goflow_list_products / goflow_find_product / goflow_create_productCatalog
goflow_submit_inventory_adjustmentAbsolute on-hand set

Before you connect

This can change your live GoFlow data. Creating products, cancelling orders, submitting shipment feeds and setting inventory are all real, immediate writes against whatever account your token unlocks. There is no dry-run and no undo. Use a sandbox account if you have one, and read back what the model proposes before you let it write.