MCP

MCP server

jsys exposes a Model Context Protocol server at mcp.jsys.com (or http://localhost:3002 in dev). One shared binary; your X-API-Key scopes everything.

Connect from Claude Code

{
  "mcpServers": {
    "jsys": {
      "transport": "streamable-http",
      "url": "https://mcp.jsys.com/mcp",
      "headers": { "X-API-Key": "res_live_…" }
    }
  }
}

Test with the inspector

npx @modelcontextprotocol/inspector \
  --transport streamable-http \
  --url http://localhost:3002/mcp \
  --header 'X-API-Key: res_test_…'

Tools

list_products — reseller-scoped catalog with selling price and metadata schema
get_wallet_balance — wallet balance, billing mode, credit limit
create_order — create an order; takes idempotencyKey + customer + lineItems
get_order — fetch by id with fulfillment status
list_orders — cursor-paginated with status / customerId filters
cancel_order — cancel a PENDING order; refunds the wallet

Sessions

The server uses MCP's Streamable HTTP transport with stateful sessions. On the first request the server issues an Mcp-Session-Id response header — include it on subsequent requests in the same conversation. Sessions are evicted after 30 minutes of idle time; reconnect by initializing again.