{"_id":"fluf-mcp","_rev":"11-241cc126b8b949f947558611f746fe88","name":"fluf-mcp","dist-tags":{"latest":"0.2.8"},"versions":{"0.1.0":{"name":"fluf-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"author":{"name":"FLUF.io"},"license":"MIT","_id":"fluf-mcp@0.1.0","maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"homepage":"https://fluf.io","bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"bin":{"fluf-mcp":"dist/index.js"},"dist":{"shasum":"06cb4cc29f1ed9c51a46312ef98d320d8694c6e7","tarball":"https://registry.npmjs.org/fluf-mcp/-/fluf-mcp-0.1.0.tgz","fileCount":17,"integrity":"sha512-FAzPqJN/B0akSrjHPFVuPEn1mEYShgOXYNMcF/0DunxaL59loD4DFqAUEFp3B64eFY8wg6Tc6UUgKAbh+lw4pg==","signatures":[{"sig":"MEQCIAhebqVX3NrJ2+yumf1X7gQjVV4nxUoSKxxNAq7/qyBxAiAoe4bX7GmZ3xlk07NSlZe6DyLea8FfKCCXaR+Z3WP27w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39717},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"0b8e524a7b9de71533b866a6ec6d84571e4626e5","mcpName":"io.fluf/mcp","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"flufdotio","email":"info@fluf.io"},"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/fluf-mcp_0.1.0_1785407132012_0.9746542916496941","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"fluf-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"author":{"name":"FLUF.io"},"license":"MIT","_id":"fluf-mcp@0.1.1","maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"homepage":"https://fluf.io","bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"bin":{"fluf-mcp":"dist/index.js"},"dist":{"shasum":"90d905914c52030dc092dce102ababdfaace8636","tarball":"https://registry.npmjs.org/fluf-mcp/-/fluf-mcp-0.1.1.tgz","fileCount":17,"integrity":"sha512-kjLAnPIIJL96NGHNpBEXtK5DSajUfoBmgztos6HEdG8v9aQ2X+0PxRxM4UQnpZ1V2QaZy5suGO8fg8SMeMczWw==","signatures":[{"sig":"MEUCIQCAXt/p/9s+X5SToGjyWIoqQ3QqlpLaynBiipK4O8siawIgKrhu17AbwfGy/IBQbtI0EBpkr0jEkiu27yDK2vBBLPo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":40164},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"af3ec9f57b38833afb1c7454e80bf4d5a6953648","mcpName":"io.fluf/mcp","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"flufdotio","email":"info@fluf.io"},"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/fluf-mcp_0.1.1_1785423051313_0.7768490430260571","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"fluf-mcp","version":"0.1.2","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"author":{"name":"FLUF.io"},"license":"MIT","_id":"fluf-mcp@0.1.2","maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"homepage":"https://fluf.io","bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"bin":{"fluf-mcp":"dist/index.js"},"dist":{"shasum":"0b7bad10f700231a7b2c9b2e57888ceb69023e15","tarball":"https://registry.npmjs.org/fluf-mcp/-/fluf-mcp-0.1.2.tgz","fileCount":19,"integrity":"sha512-R6f7zyFqDycCFFKQSxDntGasXahMPF6rM9CHTLMRLEhv64Tj4ecrMuzWQv9DJwGBcCI9Zon/pHEYaKTeCkRXDg==","signatures":[{"sig":"MEQCIC0dbzPZdeJEy0vSh4zf0GKqXqwSr4m4eZuNujA3I4HNAiB/VeNAxyvrvvkiOKzcCmL0VDN5lP+VH6H1sTp1yDqWwg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44923},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"5ced1043c5a51e0a1a3d71173535d2728c186714","mcpName":"io.fluf/mcp","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"flufdotio","email":"info@fluf.io"},"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/fluf-mcp_0.1.2_1785497025592_0.279435345271003","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"fluf-mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"author":{"name":"FLUF.io"},"license":"MIT","_id":"fluf-mcp@0.2.0","maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"homepage":"https://fluf.io","bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"bin":{"fluf-mcp":"dist/index.js"},"dist":{"shasum":"ec3e357d3113a575d7438b3becb6e22365b7ba47","tarball":"https://registry.npmjs.org/fluf-mcp/-/fluf-mcp-0.2.0.tgz","fileCount":21,"integrity":"sha512-9NZAONqHCm0rogZiODzMwnyNcNu/hPkuuxMyfang+RToYzZrP0PZ9db6ACWH1ih+aTlHFt0D5QmDAAMt9YNuhA==","signatures":[{"sig":"MEYCIQCEsIfvyKjFLIMmWd51esjBlB9G40d+7DI7LugqHGTi0QIhANYYXIOvipSVGAP+B+GLrhtKvMm3jxxThbT7eOIHdp5J","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":75470},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"18ded21c6a0d121f201b8c0ca6c17ceee7e51553","mcpName":"io.fluf/mcp","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"flufdotio","email":"info@fluf.io"},"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/fluf-mcp_0.2.0_1785536776445_0.17860469333996387","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"fluf-mcp","version":"0.2.1","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"author":{"name":"FLUF.io"},"license":"MIT","_id":"fluf-mcp@0.2.1","maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"homepage":"https://fluf.io","bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"bin":{"fluf-mcp":"dist/index.js"},"dist":{"shasum":"453c49db9b8b4ddc4afd982866da456f02d00a6b","tarball":"https://registry.npmjs.org/fluf-mcp/-/fluf-mcp-0.2.1.tgz","fileCount":21,"integrity":"sha512-XoGodazh9/o3+PG9ijXDX1Aq1sroxJ0ew+7XNrp7H2dAaDMJh+OKUe6EV7k5rqFL+MuBlRZNYrp2jzTENEwi+w==","signatures":[{"sig":"MEYCIQDQXsOy1vDt0H3zxYUJmP6Eu7X07uFBSzeDz+sKWJMk0AIhAIuBmWUnkdV8S3GThwYv+g9eB5p2zrRyAZEiHb2j6G6c","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":81573},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"c260fc1bf9c4bd6baebac33d1310ab77e32a626b","mcpName":"io.fluf/mcp","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"flufdotio","email":"info@fluf.io"},"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/fluf-mcp_0.2.1_1785622439560_0.4793543934394393","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"fluf-mcp","version":"0.2.2","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"author":{"name":"FLUF.io"},"license":"MIT","_id":"fluf-mcp@0.2.2","maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"homepage":"https://fluf.io","bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"bin":{"fluf-mcp":"dist/index.js"},"dist":{"shasum":"9dd0beeb72282023afc5c469ec04da103013caa6","tarball":"https://registry.npmjs.org/fluf-mcp/-/fluf-mcp-0.2.2.tgz","fileCount":21,"integrity":"sha512-lbbdWouUlvtdfVIOhtZjVLY821GrqvoJAyVykOCn/UGizeo2C/vPx844rd6ieTD1zjXkLaOJGXeyDSp9EsKB6Q==","signatures":[{"sig":"MEUCIC3F7j+RtAHFld0fuFRARhzMCzZRYomynU5DNUHjLvZWAiEAot4IARYVbXWQMeC6bxhT2JRjIzEubnD3YekrvsYxNwY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":81577},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"82b7552c700ca81ad3c41067fa322efdaeed5785","mcpName":"io.fluf/mcp","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"flufdotio","email":"info@fluf.io"},"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/fluf-mcp_0.2.2_1785700849121_0.3006088553338031","host":"s3://npm-registry-packages-npm-production"}},"0.2.7":{"name":"fluf-mcp","version":"0.2.7","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"author":{"name":"FLUF.io"},"license":"MIT","_id":"fluf-mcp@0.2.7","maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"homepage":"https://fluf.io","bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"bin":{"fluf-mcp":"dist/index.js"},"dist":{"shasum":"7a9d52dac401d5fa8a7bf1bc0a65693d0fcd714a","tarball":"https://registry.npmjs.org/fluf-mcp/-/fluf-mcp-0.2.7.tgz","fileCount":27,"integrity":"sha512-2Y59rY5bnY2O3laIgXFizvQCncMtD6UJBGCYz8rKQLUELrqYFkZEokrVu3kY7y9XAGWKYSzdiqVbB7TSI41yHg==","signatures":[{"sig":"MEYCIQCh8DtfhvqY96dsoeWezlzkTS9ChqSZY05k390a7JTFYwIhAKRaVwfxZwAoT8Jg3BFUghy11MNqThKQCPdzG4Sj5QKe","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC0dCZC6N4BjFdl53d1pKCxsNpVXJ0DIyLWLeGPBpQ/OgIgd363gC5cgekRqYmpuqEe9vgaFADTu7rR0aS6Mn2CDNY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":103373},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"4ac79152b5471855baadf4dda12e2ad4ee3b1de9","mcpName":"io.fluf/mcp","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","bundle":"bash scripts/build-mcpb.sh","prepublishOnly":"npm run build"},"_npmUser":{"name":"flufdotio","email":"info@fluf.io"},"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"tmp":"tmp/fluf-mcp_0.2.7_1790535215193_0.9859262005190979","host":"s3://npm-registry-packages-npm-production"}},"0.2.8":{"_id":"fluf-mcp@0.2.8","bin":{"fluf-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"dist":{"shasum":"829a0d65b04105d7bda540455705c88a1ab3a90d","tarball":"https://registry.npmjs.org/fluf-mcp/-/fluf-mcp-0.2.8.tgz","fileCount":29,"integrity":"sha512-4zwrx5OcvY/u9pxnfch4CFhASve5K+I7OMmNd22fZUeC5vsjnMoWN3DHC5RYw7QGYA8Zfd/wKqvdpc6Ap2lmiw==","signatures":[{"sig":"MEUCIBqVvC1/kt1g68BGyZdCB0xlA2IgH5/mGWERfcIciajyAiEA+MN52q567n4cGv3ERf0652ll5tBk5Y3tHydKOo1Zh/Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDFV56n72dylHqyRv5DVLvqVGxQT8d/ldPbzGUBCM7G/QIgH98V5/Rf3LRcmTAhph5hEhJ9TfgOEoVbFM0isRWyXHQ="}],"unpackedSize":112784},"main":"dist/index.js","name":"fluf-mcp","type":"module","author":{"name":"FLUF.io"},"engines":{"node":">=18"},"gitHead":"7b66d76f484a297244e851f0b41a0fbae3a393c4","license":"MIT","mcpName":"io.fluf/mcp","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","bundle":"bash scripts/build-mcpb.sh","prepublishOnly":"npm run build"},"version":"0.2.8","_npmUser":{"name":"flufdotio","email":"info@fluf.io"},"homepage":"https://fluf.io","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","directories":{},"maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.11.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/fluf-mcp_0.2.8_1791215808526_0.8427162276976885"}}},"time":{"created":"2026-07-30T10:25:31.783Z","modified":"2026-10-05T15:56:48.763Z","0.1.0":"2026-07-30T10:25:32.160Z","0.1.1":"2026-07-30T14:50:51.453Z","0.1.2":"2026-07-31T11:23:45.734Z","0.2.0":"2026-07-31T22:26:16.578Z","0.2.1":"2026-08-01T22:13:59.745Z","0.2.2":"2026-08-02T20:00:49.267Z","0.2.6":"2026-09-27T18:12:51.671Z","0.2.7":"2026-09-27T18:53:35.279Z","0.2.8":"2026-10-05T15:56:48.626Z"},"bugs":{"url":"https://github.com/FLUF-io/fluf-mcp/issues"},"author":{"name":"FLUF.io"},"license":"MIT","homepage":"https://fluf.io","keywords":["mcp","model-context-protocol","claude","cursor","fluf","crosslisting","depop","ebay","shopify","etsy","vinted","reselling","marketplace"],"repository":{"url":"git+https://github.com/FLUF-io/fluf-mcp.git","type":"git"},"description":"Model Context Protocol server for FLUF Connect — crosslisting, inventory sync, orders and offers across Depop, eBay, Shopify, Etsy, Vinted, Facebook and more.","maintainers":[{"name":"flufdotio","email":"info@fluf.io"}],"readme":"# fluf-mcp — FLUF Connect for AI agents\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that lets an AI\nagent (Claude, Cursor, Windsurf, Cline, and anything else that speaks MCP) work a\n[FLUF Connect](https://fluf.io) account: read inventory, list items across\nmarketplaces, read orders, ask FLUF's own assistant a question, and raise a\nsupport ticket.\n\nOne account, one token, every marketplace you've connected — the agent never has\nto learn a per-marketplace API, and never handles your marketplace credentials.\n\nThirteen **tools** are the primitives. Five **recipes** are the outcomes — named\nworkflows that chain the tools in the right order, surfaced in your client as\nslash commands. Most people want a recipe.\n\n## Recipes\n\nRecipes ship as MCP prompts. In Claude Desktop and Claude Code they appear as\nslash commands; in Cursor and other clients, in the prompt picker.\n\n| Recipe             | Outcome | Arguments |\n| ------------------ | ------- | --------- |\n| `dead_stock`       | Finds stock that isn't listed on the channels actually selling for you, ranked by what to crosslist first. | `period`, `limit` |\n| `morning_sales`    | Yesterday's trading in ninety seconds: orders, revenue, channel mix, what changed against a fair baseline. | `date`, `compare` |\n| `listing_failures` | Investigates failed and stuck listings, groups them by root cause, and proposes a fix per cause. | `channel`, `period` |\n| `expansion`        | Decides what to seed onto a newly connected marketplace, chosen to match what already sells for you. | `channel` *(required)*, `batch_size` |\n| `support`          | Diagnoses a problem through Intesa, then files a support ticket with the evidence attached. | `problem` *(required)* |\n\nEvery argument is optional unless marked, and every recipe has a sensible\ndefault — `/dead_stock` on its own works.\n\n```\n/dead_stock period=\"30 days\" limit=10\n/morning_sales compare=previous_week\n/expansion channel=vinted batch_size=25\n```\n\nTwo things the recipes are deliberately strict about, because getting them wrong\nis how an agent loses a seller's trust:\n\n- **Nothing gets listed without confirmation.** `dead_stock` and `expansion`\n  research and recommend; they call `crosslist` only after you say yes.\n- **Queued is reported as queued.** Extension-first channels finish in your own\n  browser, so an item can be accepted but not yet live. The recipes say so\n  rather than claiming success, and they don't re-push (a repeat can duplicate\n  the listing).\n\n## Tools\n\n| Tool            | What it does |\n| --------------- | ------------ |\n| `list_channels` | Which marketplaces this account has connected, and which it can list to. |\n| `list_products` | Your products, with the channels each one is already live on. |\n| `crosslist`     | List one or more products on one or more marketplaces. |\n| `get_orders`    | Your orders across every connected marketplace, in one shape. |\n| `list_drafts`   | Listings a marketplace refused for a fixable reason (size, brand, category, price, wording), with the reason and the editable fields — plus anything waiting for your go-ahead. |\n| `approve_draft` | Correct a draft's fields and send it to the marketplace. |\n| `delete_products` | Remove products from FLUF (restorable for 60 days); optionally end their marketplace listings too. |\n| `ask_intesa`    | Ask FLUF's own assistant an open-ended question about your account — why a channel stopped syncing, what a listing error means, what sold and where. |\n| `report_bug`    | Send a short bug report to FLUF support, with the error text and ids attached. |\n\n## Get a token\n\nCreate one at <https://fluf.io/connect/developers> — in FLUF Connect that's\n**More → Developers** in the left sidebar. It's shown once, so store it like a\npassword. Revoke it on the same screen any time.\n\nYou need a FLUF Connect account on an active plan; the API is a paid feature.\n\n## Install\n\n### Claude (web, desktop, mobile) — no install, no token (recommended)\n\nFLUF runs a hosted copy of this server at `https://fluf.io/wp-json/fc/mcp`. In\nClaude, open **Customize → Connectors → Add → Add custom connector**, enter that\nURL, select **Connect**, sign in to FLUF and choose **Allow**. That's it: no\ntoken to copy, and it works in the Claude mobile apps too. Revoke access by\ndeleting the **Claude** token under **More → Developers** in FLUF Connect.\n\nAny other client that connects to a remote MCP URL can use the same address,\nwith OAuth or an `Authorization: Bearer fluf_pat_…` header.\n\n### Claude Desktop — one-click bundle\n\nDownload **`fluf-mcp-<version>.mcpb`** from the\n[latest release](https://github.com/FLUF-io/fluf-mcp/releases/latest) and open it.\nClaude Desktop shows an install dialog, asks for your token in a form field, and\nthat's it — no terminal, no JSON, and **no Node install**: Claude Desktop ships\nits own Node runtime and uses it for installed bundles.\n\n### Everything else — npx\n\nFor Cursor, Claude Code, Windsurf, Cline, or if you'd rather manage it yourself.\n**This route does need [Node](https://nodejs.org) 18+ on your machine** — the\nruntime bundled with Claude Desktop is only used for installed `.mcpb` bundles,\nnot for `claude_desktop_config.json` entries, which spawn `command` from your\nsystem PATH.\n\n```bash\nnpm install -g fluf-mcp\n```\n\n## Configure\n\nOnly needed for the npx route — the `.mcpb` bundle configures itself.\n\n### Claude Desktop\n\n`~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"fluf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fluf-mcp\"],\n      \"env\": { \"FLUF_API_TOKEN\": \"fluf_pat_...\" }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add fluf --env FLUF_API_TOKEN=fluf_pat_... -- npx -y fluf-mcp\n```\n\n### Cursor\n\n`~/.cursor/mcp.json` (or a per-project `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"fluf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"fluf-mcp\"],\n      \"env\": { \"FLUF_API_TOKEN\": \"fluf_pat_...\" }\n    }\n  }\n}\n```\n\n### Environment variables\n\n| Var              | Required | Default           | Notes |\n| ---------------- | -------- | ----------------- | ----- |\n| `FLUF_API_TOKEN` | yes      | —                 | Your personal access token. |\n| `FLUF_BASE_URL`  | no       | `https://fluf.io` | Override for staging. |\n\n## Using it\n\nReach for a [recipe](#recipes) when you want an outcome — they encode the tool\norder and the caveats. Otherwise ask in plain language and the agent picks the\ntools:\n\n> \"What have I got in stock that isn't on eBay yet? List the ten cheapest.\"\n\n> \"Show me everything that sold last week and which channel it sold on.\"\n\n> \"Why did my last five Vinted listings fail?\"\n\nThree things worth knowing:\n\n- **Always call `list_channels` first.** The available marketplaces differ per\n  account and change over time; don't hardcode a list.\n- **`crosslist` is not always instant.** Some channels are handed to your own\n  browser session to complete, so the response may say *queued* rather than\n  *listed*. Read the per-channel status; don't assume success.\n- **`ask_intesa` is the slow, clever one.** It hands the question to Intesa, the\n  assistant inside FLUF, which runs its own multi-step investigation before\n  answering — so it can explain *why* something happened, not just report what\n  is. Replies can take up to a minute. Use the direct tools for simple reads;\n  reach for this when the question is diagnostic or open-ended.\n\n## Develop\n\n```bash\nnpm install\nnpm run build\nFLUF_API_TOKEN=... node dist/index.js\n```\n\nSmoke-test without an MCP client:\n\n```bash\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' \\\n  | FLUF_API_TOKEN=... node dist/index.js\n\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"prompts/list\"}' \\\n  | FLUF_API_TOKEN=... node dist/index.js\n```\n\nRecipes live in [`src/prompts.ts`](src/prompts.ts) — one entry in `RECIPES` per\nrecipe, no registration step. They're plain text aimed at the agent, so editing\none needs no client change.\n\n## Support\n\n<info@fluf.io>\n\n## License\n\nMIT — see [LICENSE](LICENSE). © FLUF.io.\n\nThe server itself is open; the account it talks to is not. You'll still need a FLUF\nConnect account on an active plan for any of it to do anything.\n\n### Durable eBay crosslisting tasks\n\nVersion 0.2.8 includes `get_crosslisting_tasks`, `start_crosslisting_task`, `stop_crosslisting_task`, and `resume_crosslisting_task`. Start/resume require seller confirmation (`confirmed: true`); scope is 1–100 imported FLUF product IDs, one eBay connection, 1–100 attempts per UTC day, and 1–30 days. Stop supports pause or cancel. Poll progress: accepted or verifying does not mean live. See the [task API guide](https://fluf.io/developers/docs/crosslisting-tasks/). These tools require the corresponding crosslisting task API deployment on the FLUF server. If that deployment is not available, task requests return a missing-route error; upgrading the npm client alone does not enable the backend.\n\nTest the built stdio server against a local HTTP fixture with `node scripts/test-crosslisting-tasks.mjs`.\n","readmeFilename":"README.md"}