mcp · fluf-io — Claude Code MCP server: features and setup
Connect an AI agent to FLUF Connect to inspect inventory and orders, prepare marketplace listings, and investigate listing errors.
claude mcp add --env FLUF_API_TOKEN=<FLUF_API_TOKEN> --env FLUF_BASE_URL=<FLUF_BASE_URL> --transport stdio fluf-io-mcp -- npx -y fluf-mcpWhat mcp does
The server gives an agent tools for viewing products, sales channels, orders, and listing drafts. Its workflows cover unlisted stock, sales summaries, listing problems, and choosing products for a newly connected marketplace. The dead_stock and expansion workflows wait for your approval before sending listings.
You need a FLUF Connect account on an active paid plan and a FLUF_API_TOKEN. Installing through npx also requires Node 18+; pass the token as an environment variable when configuring the server. Some channels finish publishing in your browser, so a queued status does not mean the listing is live. Sending it again can create a duplicate.
What it helps with
- find products missing from connected sales channels
- compare sales across a chosen period
- trace causes of failed listings
- select products for a newly connected marketplace
- send support a problem report with supporting details
Example prompts for the agent
- Run
/dead_stockand show me products to list. - Compare last week's sales across channels.
- Investigate the recent Vinted listing failures.
How to install mcp
Platform CLI
claude mcp add --env FLUF_API_TOKEN=<FLUF_API_TOKEN> --env FLUF_BASE_URL=<FLUF_BASE_URL> --transport stdio fluf-io-mcp -- npx -y fluf-mcpReplace <…> with your own values
Platform CLI
codex mcp add fluf-io-mcp --env FLUF_API_TOKEN=<FLUF_API_TOKEN> --env FLUF_BASE_URL=<FLUF_BASE_URL> -- npx -y fluf-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"fluf-io-mcp": {
"command": "npx",
"args": [
"-y",
"fluf-mcp"
],
"env": {
"FLUF_API_TOKEN": "<FLUF_API_TOKEN>",
"FLUF_BASE_URL": "<FLUF_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"fluf-io-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fluf-mcp"
],
"env": {
"FLUF_API_TOKEN": "<FLUF_API_TOKEN>",
"FLUF_BASE_URL": "<FLUF_BASE_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e FLUF_API_TOKEN=<FLUF_API_TOKEN> -e FLUF_BASE_URL=<FLUF_BASE_URL> fluf-io-mcp npx -y fluf-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp
How do I install mcp in Claude Code?
Run claude mcp add mcp -e FLUF_API_TOKEN=<FLUF_API_TOKEN> -- npx -y fluf-mcp and replace the placeholder with your FLUF Connect token.
What does mcp do?
It connects an agent to FLUF Connect so it can inspect products and orders, prepare marketplace listings, and diagnose listing issues.
What does mcp require?
You need an active paid FLUF Connect plan and a FLUF_API_TOKEN. The npx setup also requires Node 18+.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp by other authors comes first.
