MCP server · for developers and power resellers
Your AI agent, now a deal finder
Owl Flip’s MCP server gives Claude Code, Cursor, Windsurf, VS Code Copilot and Codex 22 tools: search the deals your monitors found, price any listing against comparable UK listings, rank whole pages of scraped results by real profit, and check your monitors, stock and sales — from your desktop.
Free to connect. Analysing listings costs no credits; only monitors you start do.
- › Scrape Gumtree for “ps5 disc” and tell me what’s worth buying.
- ScraplingServer · fetch gumtree.com/search?q=ps5+disc
- owlflip · analyse_listings (24 listings)
- 1. STRONG BUY · score 86 · PS5 Disc + 2 pads — £230 → +£96 net (39% ROI) on eBay
- 2. BUY · score 71 · PS5 Disc, boxed — £260 → +£58 net (21% ROI)
- 3. PASS · score 31 · “PS5” box only — risk: box/empty listing
- › Save the first one and draft an offer.
What it is
Owl Flip’s brain, in your editor
The Model Context Protocol (MCP) is how AI agents use outside tools. The Owl Flip server is a small Node program on your machine that talks to your Owl Flip account with a personal token. Your agent decides which tool to call; Owl Flip does the maths it already does for every deal.
Find deals
Search and filter what your monitors spotted, open any deal with its comps, and shortlist the good ones.
Analyse anything you scrape
Hand it listings from any public search page. Each comes back with a verdict, Deal Score, net profit per marketplace and risk flags.
Run the numbers
Resale estimates, marketplace fees, profit and break-even, plus your stock, listings, sales, P&L and credits.
22 tools
Every tool, in plain English
Tools marked “write” need a read-and-write token. Selling and crosslisting stay in the console, where you sign in to each marketplace.
Find deals
What your monitors have already spotted.
search_deals- Search your deal feed by words, marketplace, price, profit, ROI, Deal Score, distance and freshness.
get_deal- Comparable listings, profit per resale marketplace, cost breakdown, risk flags, a suggested offer and an opening message.
save_dealwrite- Shortlist a deal on your Saved board.
list_saved_deals- Your Saved board by status, with price drops.
Analyse anything
Price listings Owl Flip has never seen.
analyse_listing- Is this one listing a good flip? Verdict, Deal Score, net profit, ROI and risk.
analyse_listings- Rank up to 50 scraped listings at once, best first. Nothing is saved; no credits used.
check_sold_prices- What an item is listed for in the UK (asking prices from listings Owl Flip has seen), with recent examples.
calculate_fees- Seller and buyer fees on any supported marketplace.
calculate_profit- Net profit, ROI, margin and break-even for a buy and sell price.
Monitors
Saved searches that scan on a schedule.
list_monitors- Status, marketplaces, deals found and credits per day.
preview_monitor- Dry-run a search: sample matches and the cost per tier. Free.
create_monitorwrite- Create one. Starts paused unless you say go.
pause_monitorwrite- Stop scanning and spending credits.
resume_monitorwrite- Start scanning again.
run_monitor_nowwrite- Scan right now instead of waiting.
Your business
Read-only views of stock, listings and money.
list_inventory- Stock with cost, value, age and where it’s listed.
add_inventory_itemwrite- Record something you just bought.
list_listings- Listings and crosslisting status per marketplace.
list_sales- Sales with fees and net profit per order.
get_business_summary- P&L for a date range, stock value and today’s sourcing.
get_credit_balance- Credits left, daily burn and runway.
list_marketplaces- Every marketplace slug and what it supports.
Also included: resources for the marketplace registry (owlflip://marketplaces), fee schedules (owlflip://fee-schedules) and the scraped-listing format, plus prompts find-deals, analyse-scraped-results and plan-monitor.
Install
Connected in three steps
Step 1
Create a token
In Owl Flip, open Settings → MCP, pick your client and access level, and create a token. Copy it: it’s shown once.
Open Settings → MCPStep 2
Build the server
From the Owl Flip folder run pnpm i, then pnpm --filter @owlflip/mcp build. It needs Node 22.
Step 3
Add it to your client
Paste the snippet for your client with your token and the full path to apps/mcp/dist/index.js, then restart the client and ask it something.
Run in your terminal
claude mcp add owlflip --scope user \
-e OWLFLIP_TOKEN=ofx_your_token_here \
-e OWLFLIP_API_URL=https://api.owlflip.site \
-- node /ABSOLUTE/PATH/TO/Owl-Flip/apps/mcp/dist/index.js
claude mcp list--scope user makes it available in every project. Check it shows “✓ Connected”.
Settings → MCP shows the same snippets with your token filled in. OWLFLIP_API_URL defaults to http://localhost:4000.
Try it
Things to ask
Paste one into your agent after connecting. Pair it with a scraping MCP server such as Scrapling to analyse live search pages.
“Find me the best Dyson V11 deals in my feed under £150 and explain the top three.”
“Scrape the first page of Gumtree and Vinted results for “nintendo switch oled”, then rank them with Owl Flip.”
“What does a PS5 Disc Edition actually sell for? Would £240 on Facebook Marketplace be a good buy?”
“Set up a paused monitor for sealed LEGO sets under £60 near Leeds and tell me what it would cost per day.”
“Which of my stock has been sitting longest, and what did I make last month?”
Security
Your account, on a leash
A token acts as you in one workspace, so we keep what it can do small.
Read-only by default
Read tokens can search, analyse and look. Changing monitors, saved deals or stock needs a read-and-write token.
Off-limits areas
No token can buy credits, change sign-in security, export or delete data, manage connections or create more tokens.
Hashed, never stored
We keep only a SHA-256 hash. The token is shown once; keep it out of git and shared configs.
Revoke instantly
Revoke a token in Settings → MCP and every client using it stops at the next request.
Scraping is up to you and your tools. Only fetch public pages, respect each site’s terms and robots.txt, keep request rates low, and never scrape behind a login. Owl Flip analyses what you send; it doesn’t fetch marketplace pages for you.
Questions, answered
Your next flip is already listed.
Start with 300 free credits — enough to run a 15-minute monitor for over three weeks. No card, no subscription, no catch.
No subscription. Pay as you go. Credits never expire.