What is the Bimedis MCP server?

It is a remote Model Context Protocol endpoint. You add one URL to ChatGPT, Claude, Cursor or any other MCP client, and the assistant can search the live Bimedis catalog of used, refurbished and new medical equipment. With your personal MCP key it can also manage your adverts and answer buyers.

Where do I get the MCP key?

Most clients never need one — they open the Bimedis sign-in page instead. If yours does, sign in on bimedis.com and open My office → API keys (bimedis.com/my-office/api-keys), then create an MCP key. The page is open to every signed-in account, on desktop and on the phone. The key is shown once. You can hold several keys — one per assistant — and revoke any of them separately without affecting the others.

What am I approving when I connect?

The Bimedis page lists the groups of access the application asked for — your profile, your adverts, your conversations — and it is all or nothing. Approving issues a key bound to that one application and limited to those groups; the application never sees your password. Revoke it in My office → API keys and your other connections keep working.

Do I have to paste a key anywhere?

No. ChatGPT, Claude and other browser clients open the Bimedis sign-in page themselves, and the key never leaves our servers. Only command-line clients and your own code need a personal MCP key, and it always travels in the Authorization header.

What can an assistant do with my account?

With your key it can list, read, create, update and remove your adverts, list and read your conversations as seller or as buyer, reply in them, start a conversation with a seller from a catalog listing, read your unread counter, and read the account name and e-mail the key belongs to. It never sees your password and cannot change your account settings or touch payments.

Which clients are supported?

Any MCP client that speaks the Streamable HTTP transport: ChatGPT in developer mode, Claude web and desktop, Claude Code, Cursor, VS Code with GitHub Copilot, Gemini CLI, Windsurf, LibreChat and others.

Does it cost anything?

No. The server is free to use for Bimedis users and for anyone searching the catalog.

Live Model Context Protocol · Streamable HTTP · 17 tools

The medical equipment marketplace, inside your assistant

Q: Do I need an account or a key?

No key is needed for catalog search. For the account tools — your adverts and your conversations — you sign in once on a Bimedis page that the assistant opens itself. Clients that cannot open a browser take a personal MCP key instead.

Q: Does reading a conversation mark it as read?

Yes. Opening a conversation through the server marks its messages as read for you, exactly as opening the chat in your Bimedis office does.

Q: Are there rate limits?

Yes. Roughly 120 tool calls per minute for one account and 180 per minute for one client IP address, plus a service-wide ceiling. Normal assistant use never approaches these numbers.

Bimedis lists hundreds of thousands of used, refurbished and new medical devices and spare parts. Point ChatGPT, Claude, Cursor or VS Code at one URL and it reads the live catalog — no account, no code. Add your personal key and it also runs your shop: adverts and buyer chats.

https://mcp.bimedis.com/connect

Add to Cursor Add to VS Code ChatGPT, Claude & the rest

Free, unauthenticated catalog search. Account tools open after a one-click sign-in: you see what the assistant asks for, approve it once, and revoke it whenever you like.

assistant · bimedis

Find a refurbished GE Logiq E9 in Europe under $40,000 and message the closest seller.

▸ search_listings { query: "Logiq E9", condition: ["refurbished"], price_max: 40000, ships_from_country: ["de", "pl", "it"] }

Three matches ship from inside the EU:

Logiq E9 XDclear, 2016 — $36,500 · Germany
Logiq E9 with 4 probes, 2015 — $33,900 · Poland
Logiq E9 BT12, 2014 — $28,000 · Italy

▸ contact_seller { listing_id: 418902, message: "Is the probe set included…" }

Sent. Ask me later and I will check the thread for their reply.

17tools in one endpoint

5work without any key

$0to use, for everyone

2 minto connect a client

What it does

Two jobs, one endpoint

The same URL serves everyone. What the assistant may do depends only on whether you handed it a key.

Search the catalog

Filter by category, producer, model, price, condition, year, stock state and the country a listing ships from, then pull the full listing — description, photos, condition, year, where it ships from. Deep-research clients get the standard search and fetch pair.

No sign-in

Run your shop

List, read, create, update and delete your own adverts; read your conversations as seller or buyer, reply in them, open a thread with a seller from any listing, and check what is still unread.

Your account

Tool catalog

Seventeen tools your assistant can call

Every tool is described to the model, so you never type a tool name yourself — you ask in your own words and the assistant picks. Here is the full surface, with nothing hidden.

Catalog

no key

Open to any client, authenticated or not. Seller phone numbers, e-mails and messenger handles are stripped from every public result.

search_listings

Search live adverts by free text plus filters: equipment or spare parts, category, producer, model, price range, condition, year of manufacture, country it ships from and stock state — sorted by relevance or cheapest first. Returns page after page of compact results.

get_listing

Full detail of one advert: the seller’s full description, price and currency, condition, year, stock, warranty, photos, where it ships from and to.

search

The OpenAI deep-research shape of the same search: id, title, url. Used automatically by ChatGPT research runs.

fetch

The deep-research companion: full text of one result by the id that search returned.

connect_account

Tells you where to start the Bimedis sign-in in your AI client (Connect / Authenticate); the account itself is connected through the client’s standard OAuth sign-in. Command-line clients use a personal MCP key instead.

Adverts & conversations

needs your key

Everything here happens as you, under the same rules as the website. Nothing touches your password, your settings or your payments.

get_my_profile

Whose key this is: account name and e-mail. Lets the assistant confirm it is working in the right account before it changes anything.

list_my_adverts

Your adverts with the same filters as the catalog, plus published and active state.

get_my_advert

One of your adverts in full, including the fields the public listing hides.

create_advert writes

Publish a new advert: category, model, producer, condition, price, year, description, photos, shipping. Returns the id and the live URL.

update_advert writes

Change price, description, stock, photos or any other field of an advert you own.

delete_advert writes

Remove an advert. Irreversible, so a well-behaved client asks you first.

list_advert_options

The reference values a valid advert needs: category tree, currencies, conditions, stock states, countries. Keeps the assistant from inventing ids.

list_conversations

Your threads, newest first, with the counterpart, the advert in question and the unread count.

get_conversation

The messages of one thread. Reading it marks the thread read for you, exactly as opening it on the site does.

send_message writes

Reply in an existing thread — as the seller or as the buyer, whichever you are in it.

contact_seller writes

Start a thread with the seller of a catalog listing. It goes to that one seller only; the site's “ask similar sellers” fan-out is never used.

get_unread_count

How many unread messages are waiting — without opening anything and without clearing the badge.

no key works for anyoneneeds your key acts inside your accountwrites changes something — clients ask before running these

How to connect

Two minutes, any MCP client

Add the endpoint — that is the whole setup. When the assistant first reaches for your account, Bimedis asks you to sign in and approve; only command-line clients that cannot open a browser still carry a personal key in an Authorization header.

One click, no key to copy

ChatGPT and Claude ask Bimedis for access themselves: a Bimedis page opens, lists what the assistant wants to reach — your adverts, your conversations — and you press Sign in and allow. Access is all or nothing, so there is nothing to tick.

The connection belongs to that one assistant: it appears in My office → API keys and revoking it leaves your other assistants and your own integrations running. The client never receives your password, and no key passes through your clipboard.

GPT

ChatGPT

Settings → Apps & Connectors → Advanced settings → turn on Developer mode (Plus, Pro, Business, Enterprise, Edu).
Apps & Connectors → Create.
Name it Bimedis, paste the URL, authentication None.
Mention Bimedis in a chat, or pick it as a Deep Research source.
The first time you ask about your own adverts or chats, ChatGPT opens the Bimedis sign-in page — approve it once.

# URL — the only thing you paste
https://mcp.bimedis.com/connect

Claude — web & desktop

Settings → Connectors → Add custom connector.
Name it Bimedis and paste the URL.
Under Authentication pick Sign in when needed — Claude pre-selects No sign-in because search works without an account, and then it never offers to connect your adverts and chats. Leave OAuth client on the recommended default. Add it.
Turn the connector on in a chat from the tools menu.
The first time it touches your account, Claude opens the Bimedis sign-in page — approve it once.

# URL — the only thing you paste
https://mcp.bimedis.com/connect

Cursor, VS Code, Windsurf

Use the one-click buttons at the top of this page, or write the server into the client's MCP config by hand. The URL is the whole config — these clients speak OAuth, so the first time the assistant reaches for your account they open the Bimedis sign-in page themselves.

{
  "mcpServers": {
    "bimedis": {
      "url": "https://mcp.bimedis.com/connect"
    }
  }
}

Claude Code & other CLIs

One command for Claude Code — no key in it. Run /mcp afterwards and pick bimedis to sign in; the browser opens the Bimedis page and the client keeps the connection itself. Any client with the Streamable HTTP transport works the same way: GitHub Copilot, Gemini CLI, LibreChat. Only your own SDK code needs a personal key in the Authorization header.

claude mcp add --transport http bimedis \
  https://mcp.bimedis.com/connect

Command-line clients

If your client cannot open a browser

Everything above happens without a key. This page is only for terminals, scripts and your own code — anything that cannot open a sign-in page. The key identifies you, so the assistant acts as you under the same rules as the website, and nothing more: outside adverts and conversations it is rejected.

Sign in on bimedis.com

Use the account that owns the adverts and conversations you want the assistant to work with.

My office → API keys

Open bimedis.com/my-office/api-keys and find the “AI assistant keys (MCP)” block. The page is open to every signed-in account, on desktop and on the phone.

Create an MCP key

Name it after the assistant (“Claude”, “ChatGPT”). The key looks like 12345|abcdef… and is shown once. Keep one key per assistant.

Give it to your client

Always as the header Authorization: Bearer YOUR_KEY. The key is never put in the address: anything in a URL ends up in browser history and proxy logs.

Treat it as a password

Anyone holding the key acts as you inside that scope. Keep it in the header, never in the URL — a URL ends up in browser history and proxy logs — and revoke it the moment it leaks.

Revoking takes one click

Press “Revoke” next to the key in the list. Only that key stops working; your other assistants and integrations keep running.

Do not confuse it with a personal API key

The same page also has “Personal API keys” (“Create API key”, for accounts with auto-posting): those are full-access REST keys for CRM and your own integrations, not limited to the assistant tools. For assistants always use “Create MCP key” — each key can be revoked on its own without touching the others.

Fair-use limits

About 120 tool calls a minute per account and 180 per client IP. Ordinary use stays far below that; if you hit a limit the tool says so and the assistant retries.

FAQ

Questions people actually ask

What is MCP, in one sentence?

The Model Context Protocol is an open standard that lets an AI assistant call outside services. Bimedis runs one, so instead of describing listings from memory, your assistant reads the live marketplace.

Do I need an account or a key?

Not for searching — catalog search and listing details are open to everyone. The twelve tools that touch your own adverts and conversations need your account: in ChatGPT or Claude you simply sign in when they ask, and only command-line clients still want a personal MCP key.

How does signing in work?

The assistant opens a Bimedis page listing what it wants to reach. You sign in there with your e-mail or with Google — the page belongs to Bimedis, the assistant never sees your password — and press “Sign in and allow”. Access is all or nothing, and the connection shows up in My office → API keys, where one click revokes it without touching anything else.

What exactly can an assistant do with my account?

List, read, create, update and remove your adverts; read your conversations as seller or buyer and reply in them; start a thread with a seller; read your unread counter. It cannot see your password, change account settings or touch payments.

Does reading a conversation mark it as read?

Yes — the same as opening that chat in your Bimedis office. If you want the unread badge to stay, ask for the unread count instead of opening the thread.

Will my message go to other sellers?

No. Starting a conversation from a listing sends it to that seller only. The website's “share with similar sellers” option is never used by the assistant.

Are seller contacts exposed in search results?

No. Phone numbers, e-mail addresses and messenger handles are stripped from public results, even when a seller typed them into a description. Contact happens through a normal Bimedis conversation.

Which clients work?

Any MCP client with the Streamable HTTP transport: ChatGPT in developer mode, Claude on the web and desktop, Claude Code, Cursor, VS Code with GitHub Copilot, Gemini CLI, Windsurf, LibreChat and others.

Are there rate limits?

Yes: roughly 120 tool calls a minute for one account and 180 for one client IP, plus a service-wide ceiling. Ordinary use stays far below that; if you do hit a limit, the tool says so and the assistant can retry a minute later.

In which language does it answer?

The server works in English. Your assistant can translate results into whatever language you chat in.

Something looks wrong — where do I report it?

Write to [email protected] with the tool name and what you asked for. The full HTTP API is documented at apis.bimedis.com.