MCP Catalog Endpoint
This site is a marketplace of MCP servers. It is also one. An agent connects to it the way it connects to anything else here, and asks the catalogue directly instead of reading these pages.
ChatGPT, Claude, Cursor and VS Code (GitHub Copilot) sign in with your mcprush account and need no key — use the buttons below; Claude Code and Codex can sign in too. Any other client connects with a key.
claude mcp add --transport http --scope user mcprush-catalogue https://mcprush.com/mcp --header 'Authorization: Bearer ${MCPRUSH_KEY}'Adds the catalogue for every project. Claude Code reads MCPRUSH_KEY each time it connects, so set it in the shell you start Claude Code from.
Each line below uses your key, and the note under it says where it goes; ChatGPT, Claude, VS Code, Claude Code and Codex can sign in instead. How to get a key — it takes about a minute, and the free tier costs nothing. In Windows PowerShell, if a command stops with ‘running scripts is disabled’, add .cmd to its name: npx.cmd, codex.cmd.
Connect with your mcprush account
ChatGPT, Claude, Cursor, VS Code (GitHub Copilot), Claude Code and Codex connect to https://mcprush.com/mcp by signing in with your mcprush account — no key to paste. The buttons above add it in one step. In VS Code, run code --add-mcp '{"name":"mcprush","type":"http","url":"https://mcprush.com/mcp"}' and sign in when it starts the server; Copilot Chat in Agent mode then has the tools. In Claude Code, run claude mcp add --transport http --scope user mcprush https://mcprush.com/mcp, then pick mcprush in /mcp and authenticate. In Codex, add it without --bearer-token-env-var and run codex mcp login mcprush-catalogue.
Search and read the catalogue as you, with five read-only tools: search_servers, get_server, list_categories, search_skills and install_command (what each returns). It cannot buy, install anything on your machine, publish or change your account. A paid listing comes back with its price; buying happens on mcprush.com, by you.
- Sign-in
- The app never sees your password: it gets a one-hour token, renewed while you stay connected (the renewal token lasts 60 days and is replaced on each use). We keep only hashes.
- Calls
- 500 tool calls a month, 60 a minute and 10 a second on every account, with hourly and daily caps (limits). We log the time, tool, status, size and which listings you were shown — never your search words or the answers (Privacy, 03). The first call adds the free mcprush Catalogue to your installs.
- Disconnect
- Connected apps › Disconnect, or remove mcprush in the app. It stops at once.
- Every search is refused
- Confirm your email: from the sign-up email, or after signing in on mcprush.com.
- The app asks you to sign in again
- A password change or 60 days unused ends the connection. Connect again; nothing is lost.
- Allow leads to an error page
- The sign-in request expired (it lasts 30 minutes). Start again from the app and check the account on the consent page (Not you? switches it).
- A limit was reached
- The answer names the limit and when to try again: 500 calls a month, 60 a minute, 10 a second, about 120 an hour and 400 a day, and a cap on how many different listings an account is shown per hour, day and 30 days.
- Fewer results than expected
- Broad searches are narrowed, and so are answers to an account that was shown many different listings lately; the answer says which. Name the task in a word or two: “postgres”, “calendar”.
- “The catalogue could not answer that just now”
- A temporary error. Try again in a minute; if it repeats, email support@mcprush.com with the time.
Getting a key
Every client that does not sign in with your account (the apps above do) needs a key: the endpoint answers 401 to a call with neither. Nothing here costs money.
- Create an account — with GitHub, Google, or an email address and a password.
- Open Dashboard → Access and click Issue a key. This is the buyer key. A publisher API key from Studio is a different thing — it signs publishing calls, and the gateway does not take it.
- Copy it once. It is shown a single time and works for a year; if it is lost or expires, rotate it on the same screen.
- Put it in your shell. macOS and Linux:
Windows PowerShell:export MCPRUSH_KEY=mcpr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Both last until the window closes. To keep the key, add the line to ~/.zshrc or ~/.bashrc, or on Windows run setx MCPRUSH_KEY mcpr_… once and open a new terminal.$env:MCPRUSH_KEY = 'mcpr_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
The catalogue gives every account 500 tool calls a calendar month, 60 a minute and 10 a second (20 on Pro) — plenty for an agent installing things. It also caps calls at about 120 an hour and 400 a day, and how many different listings an account is shown in full at about 20 an hour and 60 a day; the sizes vary by account. A refused call says when to try again, and neither it nor the same call repeated within 15 minutes counts. Connecting and listing the tools are free. The calls also count toward your account’s monthly limit for all servers together (50,000 on a free account). Each call is logged with the key that made it, and Dashboard › Access shows the day each key was last used.
What it can ask
Words, a category, free-only. Comes back with what each server does, its grade — of its code, or of the tools a remote server lists — how many tools it declares and what it costs.
The line to run or the config block to write for the client the agent names — Claude Code if it names none — or an honest refusal where that client cannot run the server. A paid listing answers with its price and pricing link too (in ChatGPT, its price and its page).
One server in detail: what it does, its price, up to 20 of the tools it declares and how many there are, its grade and what that grade is of, how many findings the scan made and when it ran.
Agent skills — folders of instructions rather than servers. A free one downloads without a key at all.
The headings, and roughly how many live servers sit under each.
Two things worth knowing
Search does not hand back package names. It returns what an agent needs in order to choose — what a server does, whether it is safe, what it costs. The install line comes from install_command, one listing at a time. An agent picks one thing from a list, so this costs it nothing; copying the catalogue would take one call per listing, and each account is shown only a bounded number of different listings.
An agent cannot buy anything. Where a listing is paid, the answer carries the price and the pricing link (in ChatGPT, the price and the listing’s page), and says the command answers only once a subscription is bought and a key is set up — which a person does, on mcprush.com.
There is also /llms.txt — a plain map of this site for agents that arrive knowing none of the above — and an open read API at /api/catalogue/servers, which needs no key.