Mcp
Find and compare new and pre-owned items
Discover new and pre-owned items on Budna that fit your needs and budget. Compare options, check condition and compatibility, and plan pickup or delivery before you decide.
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. Public Explore and Account Read are read-only. The account-actions profile adds the independently consented write tools listed below, which an operator enables per deployment.
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
Public tools work with no account in the local budna-mcp binary and at https://api.budna.se/mcp. Account tools require an authenticated account resource and the corresponding permission. By default the account connection includes both the public marketplace and your own data. Self-hosted deployments can serve account tools alone. Account configuration
From the project's README.