For AI agents — MCPBundles Directory API
For MCP client apps (human connect):
MCP connect URL: https://mcp.mcpbundles.com/bundle/sharetribe
Skill page: https://www.mcpbundles.com/skills/sharetribe
Tools: 22
Live probe refreshed Nov 21, 2026 · Endpoint host mcp.mcpbundles.com
AI Skill
SKILL.md
Domain knowledge for Sharetribe — workflow patterns, data models, and gotchas for your AI agent.
Sharetribe
Operator-level surface for a Sharetribe marketplace. Every tool runs as the marketplace operator across the entire tenancy — there is no per-user scoping at this level. Users sign up via the marketplace front-end (Marketplace API), not through this surface; create-user is intentionally absent because Sharetribe does not expose it on the Integration API.
Resource hierarchy
Marketplace — the tenancy. One per credential pair. Carries name, description, currency.
Users — accounts on the marketplace. State is active, pendingApproval, banned, or deleted. Each user has a permission set controlling whether they can post listings, initiate transactions, and read marketplace content.
Listings — offers (products / services / bookable assets). State is draft, pendingApproval, published, or closed. Listings carry a price Money object (amount in minor units + ISO 4217 currency), an availabilityPlan for time-based bookings, and free-form publicData / privateData / metadata extended-data objects.
Transactions — purchases or bookings against a listing. Each transaction runs a transaction process (e.g. default-booking/release-1) which defines the allowed states and transitions. A transaction's lastTransition tells you where it is in the process.
Availability exceptions — per-listing overrides on top of the listing's availabilityPlan. Block out holidays with seats=0; add extra capacity with seats>=1.
Stock — per-listing inventory for purchase processes. Two write surfaces: set_stock is compare-and-set (race-safe); create_stock_adjustment is unconditional signed delta.
Stock reservations — read-only allocations created automatically by purchase-process transactions during checkout.
Events — append-only audit log of every mutation across the tenancy.
Pattern: combined get_* tools
Read tools that target a list-able resource accept an optional id:
No id → query the collection with page + per_page (default 25, max 100), plus resource-specific filters.
With id → fetch the single entity. The same include (JSON:API side-load) applies on both branches.
include accepts a comma-separated string or a list — both "author,images" and ["author","images"] work.
Pattern: combined upsert_listing
The upsert listing tool selects create (no id) vs update (with id) automatically. On create, title and authorId are required and state must be published or pendingApproval. On update, every field is a partial overwrite; extended-data objects merge at the top level and top-level null keys are removed.
Listing photos: upload_image → upsert_listing
The Integration API exposes a multipart image upload surface. Workflow:
Upload the image with file_url or file_content_base64 + filename.
Capture the returned id (image UUID).
Pass images: ["<uuid>"] on listing create or update.
Each image UUID attaches to one listing only. HTTP 409 image-invalid means the UUID is missing or already used elsewhere — upload a fresh image and retry. Omit images to publish without photos.
Money objects
Sharetribe represents money as {amount: <integer>, currency: <ISO 4217>}. Amount is in minor units — {amount: 1590, currency: "USD"} is $15.90, not $1,590. Always pass minor units when creating or updating prices, and always interpret returned amounts as minor units.
Pagination semantics
Sharetribe pagination is integer page (1-indexed) plus perPage, NOT an opaque cursor token. The wrapper normalizes list responses to {items, page, per_page, total, total_pages, has_more, next_page, included} so callers can iterate without parsing meta themselves.
The events stream is the exception: it advertises paginationUnsupported: true and returns total: null / total_pages: null / has_more: null. Walk it with createdAtStart + createdAtEnd windows or with the startAfterSequenceId forward cursor.
Transaction transitions
Transactions are state machines. To move a transaction along its process, call the transition transaction tool with the transaction id and the transition name (e.g. transition/accept, transition/cancel, transition/mark-delivered). The transition's params shape depends on the process definition — consult the marketplace's transaction process. Set speculative=true to validate a transition and produce the resulting transaction shape WITHOUT committing; useful for previewing line-item math before charging.
State-transition operations on listings and users
Close listing / open listing — hide / un-hide a listing without deleting. Reversible.
Approve listing — only relevant when the marketplace requires operator approval; otherwise listings reach published on create.
Approve user — moves a user from pendingApproval to active.
Update user permissions — operator-level allow/deny on postListings, initiateTransactions, read. Effect is immediate.
Operational order
Confirm the marketplace tenancy answers (get_marketplace) before anything credential-sensitive.
Discover the relevant author when working with listings — get_users first, capture the user id, then create / query listings filtered by authorId.
For booking flows, confirm the listing's availabilityPlan and any availability_exceptions in the booking window before transitioning a transaction.
For purchase flows, check current stock with get_listings (include=currentStock) before transitioning; use set_stock (CAS) for absolute updates and create_stock_adjustment for incremental deltas.
Use get_events as the canonical audit source after any operator mutation — events surface what actually happened upstream, not what the API call appeared to do.
Gotchas
No user create. Sharetribe Integration API does not expose users/create; users sign up via the Marketplace API / front-end. Tools assume the user already exists.
Listing images — upload via the Integration API image upload tool (returns an image UUID), then pass images: ["<uuid>", ...] on upsert listing. Do not pass URLs, local paths, or placeholder IDs. HTTP 409 image-invalid means the UUID is missing or already used on another listing. Omit images to publish without photos.
No user delete on this surface either. No users/delete endpoint exists on the Integration API. User deletion is a marketplace-admin-console operation. To soft-disable a user from the Integration API, use update_user_permissions to deny postListings / initiateTransactions / read.
Transitions can be permission-gated. Some processes restrict certain transitions to specific actors (customer-only, provider-only). Operator transitions go through unconditionally; if you see an upstream permission/denied error, the process definition is gating the transition rather than auth failing.
expand=true is on by default for every write tool — the response is the full updated entity, not just the id. Set expand=false to opt into a smaller response.
Closed-listing edits. A closed listing can still be updated (upsert_listing with id) but will not become visible until open_listing is called.
Events are returned OLDEST-FIRST.get_events page 1 is the oldest events on the marketplace, not the newest. There is no descending sort. To answer "most recent N events", pass createdAtStart=<recent ISO timestamp> to narrow the window, or walk the stream with startAfterSequenceId until exhausted and read the tail. Do NOT call page-1 results "the most recent".
set_stock is CAS-only — oldTotal and newTotal are REQUIRED. Sharetribe's compare_and_set body uses listingId, oldTotal, and newTotal (not total). Read current stock first via get_listings(id=<listing>, include='currentStock') and pass that value as oldTotal. If you don't have the current value or don't want a race-safe write, use create_stock_adjustment with a signed quantity instead — that endpoint is unconditional and incremental.
All time-window arguments require explicit timezone. ISO-8601 timestamps passed to availability tools, stock-adjustment queries, transaction filters, and event windows MUST include a Z suffix or full UTC offset (e.g. +01:00). Naive timestamps are rejected with HTTP 400. When converting local times, account for DST yourself — UK in May is BST (UTC+1), so 9am UK = 08:00:00Z.
MCPBundles publishes this directory for MCP discovery. Except where we host or operate an offering, third-party services run under their own terms. Product and company names on this page are used in a descriptive, identifying way (including under nominative fair use where applicable); they remain the property of their owners. Nothing here grants you rights in those marks, and nothing here is an offer to sell a third party's services. Terms
Sharetribe
Add to your AI client, then sign in once when you connect.
Sharetribe is a hosted marketplace platform. Use the Integration API to manage marketplace users, listings, transactions, availability, stock, and the audit event stream as the operator. Server-to-server only — there is no end-user Sign-in flow on this surface.
This listing identifies a third-party integration. MCPBundles is not affiliated with, sponsored by, or endorsed by the service or its operator unless stated on this page.
Approve a listing whose state is 'pendingApproval'. Requires id. Only relevant when the marketplace requires operator approval before listings go live; for marketplaces with auto-approve, listings reach 'published' on create and this tool is unnecessary.
Sharetribe Approve Listing — Approve a listing whose state is 'pendingApproval'. Requires id. Only relevant when the marketplace requires operator approval before listings go live; for marketplaces with auto-approve, listings reach 'published' on create and this tool is unnecessary.
Sharetribe Approve User — Approve a marketplace user whose state is pendingApproval. Requires id. Idempotent on a terminal state (already-approved users surface an upstream error rather than double-approve). Approved users move to state=active and gain the marketplace's default permission set.
Sharetribe Close Listing — Close a listing — hides it from search results and prevents new transactions, without deleting. Requires id. The listing's state moves to 'closed'. Reversible by opening the listing again.
Sharetribe Create Availability Exception — Create an availability exception on a listing: a time range with a seat count that overrides the listing's availabilityPlan for that window. Use seats=0 to block out a range (e.g. holidays, maintenance) or seats>=1 to add extra capacity. The exception cannot overlap an existing one — delete the conflicting exception first. start and end are ISO-8601; the range must be within the listing's plan horizon.
Sharetribe Create Stock Adjustment — Change listing stock by a signed amount (+5, -3). Requires listingId and quantity. Does not need the current total. Use for restocks and manual corrections; use set stock when you need an exact final count.
Sharetribe Delete Availability Exception — Delete an availability exception by id. Removes the override and restores the listing's default availabilityPlan for that window. Idempotent: deleting an already-deleted id surfaces an upstream 404 rather than double-deleting.
Sharetribe Get Availability Exceptions — Get availability exceptions for a single listing within a time window. Requires listingId, start, end (ISO-8601 timestamps; the window must be within the listing's plan horizon). Returns exception objects with start, end, seats, and createdAt. Use to inspect overrides before creating a booking transition that would otherwise be blocked by the listing's default availabilityPlan.
Frequently Asked Questions
What is the Sharetribe MCP server?
Sharetribe is a hosted marketplace platform. Use the Integration API to manage marketplace users, listings, transactions, availability, stock, and the audit event stream as the operator. Server-to-server only — there is no end-user Sign-in flow on this surface. It provides 22 tools that AI agents can use through the Model Context Protocol (MCP).
How do I connect Sharetribe to my AI agent?
Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/sharetribe. Authentication is handled automatically.
Sharetribe Get Events — Get marketplace events from the audit stream. ORDERING: events are returned OLDEST-FIRST by sequenceId — page 1 is the oldest events on the marketplace, NOT the most recent. There is no descending sort and no `latest=true` switch. To answer 'what are the N most recent events?', either (a) pass createdAtStart=<recent ISO timestamp> to narrow the window then read the tail of the returned items, or (b) walk the stream with startAfterSequenceId until the response is empty and the last items in your
Sharetribe Get Listings — Get marketplace listings. With no id, returns a paginated list (page+per_page, 25/100 default/max). With id, fetches a single listing. include is comma-separated string or list — common values are 'author', 'images', 'marketplace', 'currentStock'. Each listing carries title, description, state (draft|pendingApproval|published|closed), price (amount + currency minor units, e.g. 1590 USD = $15.90), geolocation (lat+lng), publicData / privateData / metadata extended-data objects, availabilityPlan (
Sharetribe Get Marketplace — Get the Sharetribe marketplace tenancy: id, name, description. Zero-arg, zero-cost. Use as a sanity check that the bound Integration API client_id + client_secret authenticate.
Sharetribe Get Stock Adjustments — List stock changes for a listing in a time window. Requires listingId, start, and end (ISO-8601). Each row has a signed quantity, timestamp, and cause.
Sharetribe Get Stock Reservation — Get one stock reservation by id. Reservations hold stock during checkout and are created by transactions, not by this API. include can side-load listing or transaction.
Sharetribe Get Transactions — Get marketplace transactions. With no id, returns a paginated list (page+per_page, 25/100 default/max). With id, fetches a single transaction. include is comma-separated string or list — common values are 'customer', 'provider', 'listing', 'booking', 'reviews', 'messages', 'stockReservation'. Each transaction carries lastTransition (the most recent process transition name), processName, processVersion, lineItems (price breakdown), payinTotal / payoutTotal Money objects, createdAt, lastTransition
Sharetribe Get Users — Get marketplace users. With no id, returns a paginated list (page+per_page, 25/100 default/max). With id, fetches a single user. The include parameter side-loads related resources via JSON:API include=, comma-separated string or list — common values are 'profileImage', 'stripeAccount', 'marketplace'. Each user carries email, emailVerified, state (active|banned|deleted), permissions (postListings, initiateTransactions, read), and a profile sub-object with firstName, lastName, displayName, bio, pu
Sharetribe Open Listing — Open a closed listing — moves state back to 'published' and makes it visible in search again. Requires id.
Sharetribe Set Stock — Set a listing's stock to an exact total. Requires listingId, oldTotal (current stock as you last read it), and newTotal. Read the listing with include=currentStock first and pass that count as oldTotal. Sharetribe rejects the write if stock changed since you read it — re-read and retry. To add or remove a fixed amount without setting an exact total, use create stock adjustment.
Sharetribe Transition Transaction — Apply a process transition to a transaction as the operator. Requires id and transition (e.g. 'transition/accept', 'transition/cancel', 'transition/mark-delivered'). params is the transition-specific arguments object — varies per process; consult the marketplace's transaction process definition. Set speculative=true to validate the transition and produce the resulting transaction shape WITHOUT committing — useful for previewing line-item math (taxes, fees, payout) before charging. The returned p
Sharetribe Update Transaction Metadata — Update a transaction's metadata object (top-level merge). Requires id and metadata. metadata is operator-only key/value data — it is NOT visible to customer or provider users via the Marketplace API. Top-level keys with value null are removed; nested values are set as-is. The total metadata object cannot exceed 50KB as JSON.
Sharetribe Update User Permissions — Set per-user permissions on the marketplace. Requires id and at least one of postListings / initiateTransactions / read. Each value is 'permission/allow' or 'permission/deny'. Operator-level command — bans a user from listing, transacting, or even reading marketplace content without deleting the account. Effect is immediate.
Sharetribe Update User Profile — Update a marketplace user's profile and extended data. Requires id. firstName / lastName / displayName / bio are optional string overrides; passing null on bio clears it. publicData, protectedData, privateData, metadata are merged at the top level (non-deep) — top-level keys with value null are removed. Each extended-data object is capped at 50KB as JSON. profileImageId expects an image UUID previously uploaded via the Sharetribe Console / Marketplace API; the Integration API exposes no image up
Sharetribe Upload Image — Upload an image to Sharetribe via the Integration API images/upload endpoint. Returns the image UUID to attach when creating or updating a listing — each UUID attaches to one listing only. Provide exactly one of: file_content_base64 (max 1 MB inline), file_url (up to 100 MB images), or local_path (absolute path on the user's computer). Use list_local_directory to discover paths, then pass local_path on upload tools. Install MCPBundles Desktop at https://www.mcpbundles.com/desktop if it is not co
Sharetribe Upsert Listing — Create or update a marketplace listing. Without id: POST create — title and authorId are required, state must be one of 'published' or 'pendingApproval'. With id: POST update — every field is a partial overwrite; extended-data objects (publicData, privateData, metadata) merge at the top level, top-level null keys are removed. price is a Money object: {amount: <integer minor units>, currency: <ISO 4217 code>}, e.g. {'amount': 1590, 'currency': 'USD'} for $15.90. geolocation is {lat, lng} decimal
Sharetribe provides 22 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.
What authentication does Sharetribe require?
Sharetribe uses API Key. Sharetribe requires credentials. Connect via MCPBundles and authentication is handled automatically.
MCPBundles is an independent platform built on the open Model Context Protocol standard. MCPBundles is not affiliated with, sponsored by, or endorsed by Anthropic PBC.
More in ecommerce
Other MCP servers in this category from the directory index