budna-marketplace/mcp

3 stars 0 forks Quality 79 Trend 30MIT

Budna MCP for AI agents.

Overview

Use Budna from any compatible MCP client. Explore the public marketplace with no account or API key, or optionally connect your Budna account so your AI assistant can read your own account, listings, bids, offers, watchlists, saved searches, purchases, sales, disputes, messages, payments, notifications and ratings, with the permissions you choose. Budna MCP is read-only: it cannot change marketplace data. Install a prebuilt binary without Node.js or Rust: Restart your terminal if the installer adds its directory to PATH, then check budna-mcp --version. For clients that launch the server through npx: Homebrew installs Rust automatically and builds from source. Start a new Codex task after adding the server, then ask: Use Budna to find public camera listings. The Codex MCP documentation covers project-scoped configuration and other client options.

README

Budna MCP

Quick start

Shell (macOS / Linux)

Install a prebuilt binary without Node.js or Rust:

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/budna-marketplace/mcp/releases/latest/download/budna-mcp-installer.sh | sh

PowerShell (Windows)

Run in PowerShell 5.1 or newer:

irm https://github.com/budna-marketplace/mcp/releases/latest/download/budna-mcp-installer.ps1 | iex

Restart your terminal if the installer adds its directory to PATH, then check budna-mcp --version.

npm / npx

Requires Node.js.

npm install --global @budna-marketplace/mcp

For clients that launch the server through npx:

command: npx
arguments: --yes @budna-marketplace/mcp

Homebrew

brew install budna-marketplace/tap/budna-mcp

Homebrew installs Rust automatically and builds from source.

Cargo

You need Rust 1.88 or newer.

Install the latest published release:

cargo install budna-mcp --locked

To install from a local checkout:

cargo install --path crates/budna-mcp --locked

Add to Codex

On macOS or Linux:

codex mcp add budna -- "$(command -v budna-mcp)"
codex mcp get budna

On Windows PowerShell:

$budna = (Get-Command budna-mcp).Source
codex mcp add budna -- $budna
codex mcp get budna

Start a new Codex task after adding the server, then ask:

Use Budna to find public camera listings.

The Codex MCP documentation covers project-scoped configuration and other client options.

Add to another stdio MCP client

Configure the absolute path returned by command -v budna-mcp (or (Get-Command budna-mcp).Source on Windows) with no arguments:

command: /absolute/path/to/budna-mcp
arguments: none

For JSON-config clients:

{
  "mcpServers": {
    "budna": {
      "command": "/absolute/path/to/budna-mcp",
      "args": []
    }
  }
}

What you can do

Budna MCP is read-only today. Public tools work with no account in the local budna-mcp binary and at https://api.budna.se/mcp. Account tools are available only on the hosted account resource, after you connect your Budna account and grant the permission they need. The account resource also serves every public tool, so one connection covers both the public marketplace and your own data.

Tool	Access	What it does
`search_listings`	Public	Search and filter public marketplace listings
`get_listing`	Public	Get one public listing
`get_listing_attributes`	Public	Get a listing’s structured public attributes
`get_listing_related`	Public	Find public listings related to a listing
`get_seller_listings`	Public	List a seller’s public listings
`browse_listings`	Public	Browse featured listings, the newest listings or one brand’s listings
`get_categories`	Public	Browse the category tree
`get_category_filters`	Public	Get the filters available in a category
`get_filter_options`	Public	Get the options for one filter
`get_brands`	Public	List brands with their listing counts, or get one brand
`get_locations`	Public	List the regions and municipalities search can filter by in Sweden or Norway, with listing counts
`get_search_suggestions`	Public	Get listing and category suggestions for partly typed text
`get_public_seller_profile`	Public	Get a seller’s public profile
`get_seller_ratings`	Public	Get a seller’s rating statistics and the ratings they received, with stars, comment and the rater’s public username
`get_listing_bid_summary`	Public	Get a listing’s bid count and current price, without bidder identities
`get_listing_bid_history`	Public	Get a listing’s auction rounds and bid history, with bidders shown as Bidder 1, Bidder 2 and so on, as in the app. With your account connected and the Bids permission, your own bids show as You
`get_public_ratings_summary`	Public	Get a listing’s aggregate public rating signals
`get_listing_questions`	Public	Read a listing’s public questions and chat, with authors by public username
`browse_collections`	Public	Browse collections, a seller’s listings under one banner: the live ones or one seller’s
`get_collection`	Public	Get one collection and a page of its listings
`browse_live_streams`	Public	List live shopping streams on air now or coming up
`get_live_stream`	Public	Get one live stream, with the listing on stage, the auction running and the items to come
`get_shipping_rates`	Public	Get package sizes and domestic shipping prices per carrier
`get_my_account`	Account permission	Read your account ID, account type and display name
`get_my_profile`	Profile permission	Read your profile, level and badges, verification, account standing, subscription and onboarding steps
`get_my_achievements`	Profile permission	Read your achievements and your progress towards them
`get_my_referral`	Profile permission	Read your referral code, the referrals that count and your rewards, never who you referred
`get_my_legal_documents`	Profile permission	Read which version of each legal document you accepted and whether a newer one awaits you
`list_my_listings`	Listings permission	List your own listings, including drafts, with title, status, type and update time
`get_my_listing`	Listings permission	Read owner-visible details of one of your listings, including drafts and your reserve price
`list_my_bids`	Bids permission	List your bids with amount, time and status (valid, outbid, won or cancelled), or only the ones currently winning
`list_my_auto_bids`	Bids permission	List your automatic bids with the maximum you set and their status
`list_my_offers`	Offers permission	List offers you sent or received, with the other party’s public username, amount, counter-offer, status, who acted last and expiry
`list_my_second_chance_offers`	Offers permission	List second-chance offers you received after an auction you bid on
`get_my_offer_history`	Offers permission	Read each step of one offer’s negotiation: who acted, the action and the amount
`list_my_watchlists`	Watchlist permission	List your watchlists with their names and item counts
`list_my_watchlist_listings`	Watchlist permission	List the listings saved in one of your watchlists
`list_my_saved_searches`	Watchlist permission	List your saved searches with their criteria, alerts and unseen matches
`list_my_saved_search_matches`	Watchlist permission	List the listings one of your saved searches matches now
`list_my_live_reminders`	Watchlist permission	List the live streams you asked to be reminded about
`list_my_orders`	Orders permission	List your purchases or sales with the other party’s public username, payment, delivery and return status, carrier, tracking number and, for sales, your payout
`get_my_order`	Orders permission	Read one purchase or sale in detail: tracking events, return, refund and dispute status, and invoice numbers
`list_my_disputes`	Orders permission	List disputes about your purchases and sales, with your side, the reason and status
`get_my_dispute`	Orders permission	Read one dispute with both parties’ statements and the settlement offers
`list_my_order_groups`	Orders permission	List your combined shipments, several orders sent as one parcel, with their amounts, carrier and deadlines
`get_my_order_group`	Orders permission	Read one combined shipment with its orders, amounts, carrier and deadlines
`list_my_notifications`	Notifications permission	List your notifications by type, read state and related listing, order, offer or saved search
`get_my_notification_preferences`	Notifications permission	Read your notification settings: channels, categories and quiet hours
`list_my_ratings`	Ratings permission	List ratings you received or gave, with the other party’s public username, stars, comment and listing
`get_my_money_summary`	Payments permission	Read your money totals per currency: proceeds pending, on the way, paid out, on hold or in balance, and payments made and refunded
`list_my_payment_activity`	Payments permission	List your payment activity, newest first, with amount, kind and status
`list_my_payouts`	Payments permission	List your recent payouts of sale proceeds
`list_my_debts`	Payments permission	List your debts to Budna, such as fees for unpaid orders
`get_my_credits`	Payments permission	Read your priority and boost credit balances
`get_my_payout_setup`	Payments permission	Read whether you are set up to receive sale proceeds, without bank details
`list_my_conversations`	Messages permission	List your conversations with the other person’s public username, latest message and unread count
`get_my_conversation`	Messages permission	Read the messages in one of your conversations
`list_my_listing_chats`	Messages permission	List the listing chats you take part in, with the latest message and unread count
`search_my_messages`	Messages permission	Search your messages for a word or phrase
`get_my_seller_insights`	Selling permission	Read views and saves of your listings over 7, 30 or 90 days, your top listings and priority credits
`list_my_boosts`	Selling permission	List the boosts you bought, with status, price and dates
`get_my_listing_promotion`	Selling permission	Read one listing’s boosts, search priority, video processing status and, for a company, its VAT treatment
`get_my_shipping_settings`	Selling permission	Read your default carriers and combined-shipping choice
`list_my_showcases`	Selling permission	List your collections, including drafts
`list_my_live_sessions`	Selling permission	List your live streams with items sold and revenue
`list_my_listing_tags`	Selling permission	List scans and saves of your in-store listing tags
`list_my_following`	Following permission	List who you follow, by public username
`list_my_followers`	Following permission	List who follows you, by public username
`list_my_companies`	Company permission	List your companies, your role in each and invitations sent to you
`get_my_company`	Company permission	Read one of your companies, its members by public username and its invoicing status

In compatible MCP Apps clients you can also browse interactive listing cards and explicitly ask the AI to compare two to four selected listings.

Budna MCP cannot currently bid, make offers, buy, message, record views, change account settings, or otherwise change marketplace data.

Permissions you control

When you connect an app, Budna shows exactly what it asks for and you choose which permissions to grant: Account (account:read), Listings (listings:read), Bids (bids:read), Offers (offers:read), Watchlists and saved searches (watchlist:read), Orders (orders:read), Notifications (notifications:read), Ratings (ratings:read), Payments (payments:read), Messages (messages:read), Profile (profile:read), Selling (selling:read), Following (following:read) and Company (company:read).
Account tools name the other buyer or seller only by the public username the app shows, and never reveal who bid on a listing. Addresses, contact details and notification text are never included; message text is shared only with the Messages permission, and dispute statements only with the Orders permission.
Under Account → Security → Connected apps you can remove a permission or disconnect an app at any time. Removing a permission takes effect immediately, including for access the app already holds; restoring it requires approving the app again.
A connection lasts at most seven days before you approve it again.
Disconnecting stops future access, but cannot recall information already shared with the AI service.

Where Budna MCP is going

Budna MCP is growing toward everything you can do in the Budna app and on the web. Next come actions such as bidding, making offers, buying, selling and managing your listings, and messaging. Each new capability will arrive behind its own permission that you grant per app, sensitive actions such as bids and purchases will ask for your explicit confirmation, and you can reduce or revoke access at any time. None of these actions are available yet.

Connect your Budna account

Add https://api.budna.se/account/mcp to your AI client as a remote (Streamable HTTP) MCP server. The client opens your browser to sign in to Budna at https://connect.budna.se and shows which permissions it requests; you choose which to grant. See Permissions you control for reducing or removing access later.

Client	Setup
Claude Code	`claude mcp add --transport http budna https://api.budna.se/account/mcp`, then `/mcp` to authenticate
Codex	`codex mcp add budna-account --url https://api.budna.se/account/mcp`, then `codex mcp login budna-account`
ChatGPT	Add a custom connector with the URL, OAuth client ID `budna-chatgpt` and no client secret
Claude (web and desktop)	Add a custom connector with the URL and OAuth client ID `budna-claude`
Visual Studio Code	Add the URL as an HTTP MCP server
goose	Add the URL as a remote extension
Gemini CLI	Add the URL with `oauth.clientId` set to `budna-gemini-cli`
Cursor	Add the URL with OAuth client ID `budna-cursor`

Other clients are not accepted yet. See Account access for the full permission model and the data each tool returns.

Use a non-production environment

Configure these values together so API requests, public listing links, and images stay in the same environment:

Setting	Purpose
`BUDNA_API_URL`	Budna API base URL, including `/api/v1` if applicable.
`BUDNA_PUBLIC_LISTING_ORIGIN`	Origin used for returned listing links.
`BUDNA_IMAGE_ORIGIN`	Origin used for returned image URLs and the App CSP.

Remote API URLs must use HTTPS; HTTP is accepted only for loopback development servers. Listing and image values must be canonical HTTPS origins with no credentials, path, query, fragment, or wildcard host. The binary does not load .env files itself; .env.example is reference material.

For example, register a separate Codex server for another environment:

codex mcp add budna-nonprod -- /absolute/path/to/budna-mcp \
  --api-url https://api.your-environment.example/api/v1 \
  --public-listing-origin https://marketplace.your-environment.example \
  --image-origin https://images.your-environment.example

Equivalent environment variables are supported when your client can provide them.

Interactive cards

The Marketplace Explorer is embedded in the binary. Clients that support the MCP Apps extension can render listing cards, details, related/seller listings, and comparison selection. Other clients receive the same text and structured JSON fallback. See the extension support matrix for client coverage.

See the Marketplace Explorer guide for local HTTP testing, temporary-tunnel safety, privacy and attribution behavior, UI development, and release checks.

The project is licensed under the MIT License.

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "budna": {
      "command": "/absolute/path/to/budna-mcp",
      "args": []
    }
  }
}