Use Yarkii with your AI Assistant
Connect Meta Muse, Claude Code, ChatGPT, or any MCP assistant to Yarkii. Ask what is ready to sell, prepare complete listing packages with high-res photos and package weights, post directly to Facebook Marketplace, and keep inventory automatically synced with eBay.
What you can ask your AI
Five-minute tutorial: your assistant can run these commands directly over MCP.
📦1. Check Ready Inventory
Find items stored in bins that passed the 6-month hold.
- "What items are ready to sell on Facebook Marketplace?"
🖼️2. Fetch Listing Package
Get photos, dimensions, shipping weight, and formatted description.
- "Get the listing package for soaring-fox"
🚀3. Post to FB Marketplace
Meta Muse posts the item and records the active listing URL.
- "Post soaring-fox to Facebook Marketplace for $45"
🔄4. Two-Way Cross-Delist
If it sells on eBay, Muse delists it. If it sells on FB, eBay ends.
- "Check for any delisted items that sold on eBay"
1. Stored & Cleared
Inspected, weighed, photographed in a bin, and past the 6-month hold.
2. Complete Package
Signed high-res photo URLs, dimensions, condition, and suggested pricing.
3. Published via Muse
Posted to Facebook Marketplace for local pickup or shipping.
4. Cross-Delisting
Automatic two-way sync: sales on either platform end the other listing.
Set it up: one copy, one paste 📋
Pick your assistant below, click Copy Connection Prompt, and paste it into a chat with it. The prompt contains everything the assistant needs to connect.
Meta Muse (Facebook Marketplace)
Add Yarkii as a custom connector in Muse, then list products directly onto Facebook Marketplace.
Please add Yarkii as a custom connector, then help me sign in. MCP server URL: https://www.yarkii.com/api/mcp Authentication: OAuth 2.1 (sign in with my Yarkii account) It uses OAuth 2.1 authentication: when you connect, a Yarkii authorization screen opens where you log in and click Allow. Dynamic client registration (PKCE S256) is supported automatically. Available tools: - `my_account`: View your connected Yarkii account info, user ID, and inventory counts. - `list_items_ready_to_sell`: List items from inventory that have captured photos and are ready to be listed on Facebook Marketplace. - `get_item_listing_package`: Get complete listing data for an item (title, formatted description, dimensions, condition, and signed photo URLs) to post onto Facebook Marketplace. - `record_marketplace_listing`: Record that an inventory item has been posted to Facebook Marketplace (or another platform), tracking its listing URL and price. - `record_marketplace_sale`: Record that an item has sold on Facebook Marketplace (or another platform). - `delist_marketplace_listing`: Mark an item as removed/delisted from Facebook Marketplace or other external sales channels. - `list_marketplace_listings`: List items that are currently active, sold, or delisted on external marketplaces. - `import_facebook_listings`: Import active listings from Facebook Marketplace (https://www.facebook.com/marketplace/you/selling) into Yarkii so they can be tracked, synchronized, and cross-listed to eBay. How to list items on Facebook Marketplace with Yarkii: 1. Call `list_items_ready_to_sell` to view items with captured inventory photos that are ready to sell (strictly past the 6-month hold). 2. When an item is chosen, call `get_item_listing_package` with its slug. 3. You will receive: - High-resolution signed photo URLs from the user's inventory scanner - Product title and suggested price - Condition: exact FB enum (new, used-like new, used-good, used-fair, refurbished) - Category and location (30022 Alpharetta/Johns Creek) - Meetup/delivery defaults (Cash + door pickup, porch pickup anytime) - Short, factual description (brand, model, dimensions, what's included, tested status) - Pre-formatted `approval_card_template` ready for Muse's listing approval card 4. Create the listing on Facebook Marketplace: - Required to create: Title, Price ($) - Required to go live (not draft): Photos (at least 1), Condition, Category, Location (30022) - Delivery: Cash + door pickup (porch pickup anytime), price firm - Always present the approval card to the seller before posting! 5. Call `record_marketplace_listing` with the slug, price, and listing URL so Yarkii records it. Two-Way Cross-Delisting Sync: - When an item sells on Facebook Marketplace: Call `record_marketplace_sale` with the slug and price. This marks the item sold and automatically ends the corresponding eBay listing. - When an item sells on eBay: Call `list_marketplace_listings(status: 'delisted')` regularly. If any item has reason "Sold on eBay", remove or archive its Facebook Marketplace post immediately to avoid double-selling. Importing from Facebook Marketplace to Cross-List to eBay: - Read active items from https://www.facebook.com/marketplace/you/selling and call `import_facebook_listings` with titles, prices, listing URLs, photos, and descriptions. - Once imported into Yarkii, the user can cross-list them to eBay from the Imported tab.
How Meta Muse Lists onto Facebook Marketplace:
- 1. Connect: Paste the prompt above into your Meta Muse chat. Muse will register itself and open the Yarkii authorization screen.
- 2. Choose Items: Ask Muse: "What items are ready to sell?"Muse calls Yarkii's MCP server to view items with captured inventory photos.
- 3. Construct & Post: Muse pulls high-res photos, dimensions, suggested pricing, and formatted descriptions, then creates the post on Facebook Marketplace.
- 4. Record: Muse records the listing URL in Yarkii so your inventory stays synchronized.
📋 Facebook Marketplace Listing Checklist (Meta Muse Guidelines):
Required to Create:
- Title: Clean, descriptive item title
- Price: Dollar amount (or comps-based price)
Required to Go Live (Not Draft):
- Photos: At least 1 (front/back/sides, labels, seals)
- Condition:
new,used-like new,used-good,used-fair, orrefurbished - Category: Toys, electronics, furniture, hobbies, etc.
- Location: 30022 (Alpharetta / Johns Creek)
Delivery & Meetup:
- Pickup: Door pickup / porch pickup anytime
- Payment: Cash on pickup (price firm)
Short & Factual Description:
- Brand, model or set number, dimensions
- What's included and flaw details
- Quantity (single vs lot) and functional test status
- Interactive approval card before posting
What your AI can do
Read tools inspect inventory. Write tools record listings. Sensitive write records sales and triggers automatic cross-delisting from eBay.
| Tool | Kind | Scope | Description |
|---|---|---|---|
| my_account | Read | inventory:read | View your connected Yarkii account info, user ID, and inventory counts. |
| list_items_ready_to_sell | Read | inventory:read | List items from inventory that have captured photos and are ready to be listed on Facebook Marketplace. Supports filtering by size ('large' for heavy/oversized items ideal for local pickup) and sorting by highest value. |
| get_item_listing_package | Read | inventory:read | Get complete listing data for an item (title, formatted description, dimensions, condition, and signed photo URLs) to post onto Facebook Marketplace. |
| record_marketplace_listing | Write | listings:write | Record that an inventory item has been posted to Facebook Marketplace (or another platform), tracking its listing URL and price. |
| record_marketplace_sale | Sensitive Write | listings:write | Record that an item has sold on Facebook Marketplace (or another platform). Automatically marks the item as sold, updates the order, and ends the active eBay listing to prevent double-selling. |
| delist_marketplace_listing | Write | listings:write | Mark an item as removed/delisted from Facebook Marketplace or other external sales channels. |
| list_marketplace_listings | Read | inventory:read | List items that are currently active, sold, or delisted on external marketplaces. Essential for checking which items sold on eBay and must be removed from Facebook Marketplace. |
| import_facebook_listings | Write | listings:write | Import active listings from Facebook Marketplace (https://www.facebook.com/marketplace/you/selling) into Yarkii so they can be tracked, synchronized, and cross-listed to eBay. |
Limits, checks and hold rules 🤝
- 6-Month Hold Rule: Strictly enforced server-side. Items marked for sale that were received within the last 6 months are never exposed to agents or released for listing.
- High-Resolution Photos: Served as secure signed URLs directly from your private storage bucket (1-hour expiry). Only items with photographed units are marked ready for sale.
- Cross-Delisting Safety: When an item sells on Facebook Marketplace, the MCP server immediately withdraws the live eBay offer. When an item sells on eBay, it is flagged as delisted so Muse can remove it from Facebook Marketplace.
- Rate Limits: 120 requests/minute per connected user agent (20 requests/minute for unauthenticated discovery).
- Privacy & Security: AI assistants only see eligible inventory items and cannot view your account passwords, API tokens, or billing info.
If you write code 🛠
A standard Model Context Protocol (MCP) server over Streamable HTTP (revision 2026-07-28 with 2025 legacy handshake support). OAuth 2.1 with PKCE S256, Dynamic Client Registration (RFC 7591), and Protected Resource Metadata (RFC 9728).
Protected resource metadata: https://www.yarkii.com/.well-known/oauth-protected-resource/api/mcp