How it worksFeaturesDocsEarly accessGitHubDashboard

How to integrate Sharetribe Marketplace API using MCP

Marketplace listings, user flows and transactions. This guide creates an MCP server from Arthur's Sharetribe Marketplace API template — tools preconfigured against https://flex-api.sharetribe.com — and finishes by sharing the server's MCP swagger documentation.

Steps

  1. Open the Secrets vault and create a secret named SHARETRIBE_MARKETPLACE_API_KEY holding your access token. Use an access token in the Authorization header. Obtain it through the Sharetribe Authentication API or the Sharetribe SDK; some endpoints accept anonymous tokens, while others require an authenticated user token.

    Open the Secrets vault to store the Sharetribe Marketplace API credential before using the template

    Start the New secret wizard

    Name the secret SHARETRIBEMARKETPLACEAPIKEY — servers reference it by this name

  2. Go to the REST API Templates gallery and search for Sharetribe Marketplace API.

    Record what the credential is for so it stays recognizable

    Continue to the protected value step

  3. Click Use template on the Sharetribe Marketplace API card to open the server-creation dialog.

    Enter the credential value — a demo value here; use your real key when adopting the integration

    Review the generated secret reference syntax

  4. Review the server name and select SHARETRIBE_MARKETPLACE_API_KEY in the credential field — the dialog only accepts vault secrets, and it lists every tool that will be created.

    Store the SHARETRIBEMARKETPLACEAPIKEY secret in the vault

    Open the REST API template gallery

    Search the gallery for the Sharetribe Marketplace API integration

  5. Click Create server. Arthur creates the server, applies the authentication, and generates all the tools.

    Open the Sharetribe Marketplace API template with its preconfigured tools

    Name the server after the integration it provides

    Pick the SHARETRIBEMARKETPLACEAPIKEY secret from the vault suggestions

    Select the stored credential

    Create the Sharetribe Marketplace API server with its preconfigured tools

  6. Open the server's Tools tab to review the generated tools.

    Review the tools generated from the Sharetribe Marketplace API template

  7. Open the server's Connect section and click Share the MCP swagger documentation — Arthur generates the public documentation link and QR code for this server.

    Open the server's Connect section, where the MCP endpoint and its documentation live

    Open the MCP swagger documentation share panel

    Show the generated swagger documentation link and QR code for this server

Confirm it worked

The server appears with 7 preconfigured tool(s): query_listings, show_listing, query_own_listings, create_draft_listing, update_listing, publish_draft_listing, initiate_transaction. The Connect section offers the MCP swagger documentation — a shareable page with setup instructions for any AI client.

Good to know

  • Build the end-user marketplace experience with Sharetribe's Marketplace API. Browse and inspect listings, manage the authenticated user's own listings, publish drafts, and start transactions with bearer access tokens.
  • This integration requires a credential (bearer).
  • Official API documentation: https://www.sharetribe.com/api-reference/marketplace.html
  • Editing a tool later never changes the template — templates are starting points, and the server is fully yours after creation.

Related

Tutorial video