GONDI
Live NFT prices, bids, listings, sales, and lending and borrowing data from the GONDI marketplace.
Server MCP Terhosting
npx add-mcp 'https://api.gondi.xyz/mcp'Terpasang ke Claude Code, Codex, Cursor, dan lainnya
Dokumentasi
GONDI MCP Server
GONDI is an NFT marketplace with peer-to-peer lending built in. On Ethereum, Hyperliquid (HyperEVM) and Robinhood Chain you buy, sell, list and bid on NFTs, and borrow or lend against them.
The GONDI MCP server gives AI assistants live GONDI data through the Model Context Protocol: floor prices, top bids, the cheapest listings, recent sales and floor history, the top and trending collections, marketplace fees, what a wallet is worth, loan offers and lending rates, a borrower's open loans, what their NFTs can borrow and what buying with a loan costs, top lenders and their returns. Add it to your assistant once, then ask questions in plain language.
This repository describes the hosted server and is the place to report problems with it. The server itself is hosted by GONDI; there is nothing to install or run.
Endpoint
| URL | https://api.gondi.xyz/mcp |
| Transport | Streamable HTTP |
| Authentication | None: no API key, no wallet |
| Access | Read-only: it never signs or sends transactions |
| MCP Registry | xyz.gondi/mcp |
Setup
Claude (claude.ai and Claude Desktop)
- Open Customize → Connectors.
- Select + Add, then Add custom connector.
- Name it
GONDI, enterhttps://api.gondi.xyz/mcpas the URL and select Continue. - Choose No sign in under Authentication, then Add.
- In a chat, turn it on from the + button → Connectors.
On Team and Enterprise plans an owner adds the connector under Organization settings → Connectors first.
Claude Code
claude mcp add --transport http gondi https://api.gondi.xyz/mcp
Cursor
The button opens Cursor and asks you to confirm the install. Or add the server
yourself to ~/.cursor/mcp.json (every project) or .cursor/mcp.json
(one project):
{
"mcpServers": {
"gondi": {
"url": "https://api.gondi.xyz/mcp"
}
}
}
VS Code
Install the GONDI MCP server in VS Code: the link opens VS Code and shows the server for you to review before installing.
You can also run MCP: Add Server from the Command Palette, choose HTTP and enter
https://api.gondi.xyz/mcp. Or add it to .vscode/mcp.json in your workspace:
{
"servers": {
"gondi": {
"type": "http",
"url": "https://api.gondi.xyz/mcp"
}
}
}
ChatGPT
In ChatGPT on the web, open Plugins, select + and Add custom MCP
server. Enter https://api.gondi.xyz/mcp as the server URL, choose No
authentication, accept the warning and create it, then install it before using
it in a chat. Custom MCP servers depend on your ChatGPT plan and, in a workspace,
on what its admins allow.
Other clients
Any client that supports remote MCP servers over streamable HTTP works: point it
at https://api.gondi.xyz/mcp with no authentication.
Tools
The server offers 20 tools. Tools that take a slug get it from search_gondi
rather than guessing it. Wallet tools take an address, a GONDI username or an ENS
name. Chains are ethereum, hyperliquid and robinhood; currencies are
WETH, USDC, WHYPE, HUSDC, RWETH and USDG. Your client shows each
tool's full description and input schema.
Search
| Tool | What it answers |
|---|---|
search_gondi | Collections, artists, NFTs and users matching a name, each with its slug or address, chain and GONDI page. |
Market
| Tool | What it answers |
|---|---|
get_collection_market | A collection's floor price and top collection bid, in its currency and in USD, and its fees to sell and buy on GONDI against OpenSea. |
get_nft_market | One NFT's listing price, top bid, last sale, estimated value, whether it is collateral in an open loan, and what the seller keeps on GONDI against OpenSea. |
list_cheapest_for_sale | The cheapest NFTs for sale from a collection or by an artist, with the page to buy each. |
list_recent_sales | The latest sales of a collection or one NFT, with price, marketplace, buyer and seller, and the period's min, median and max price. |
get_floor_price_history | How a collection's floor moved over 7 to 365 days, one point a day, with the change in percent. |
list_top_collections | The top and trending collections, by volume, sales, trending, market cap or floor change. |
Every listing and bid the market tools answer carries gondi_fee_percent.
Lending
| Tool | What it answers |
|---|---|
get_lending_market_overview | The whole lending market in USD: open principal, interest paid and accruing, volume and APRs of new loans. |
get_supported_markets | The chains and currencies GONDI lends in, the loan contract on each chain, accepted durations and the protocol fee. |
get_lending_guide | How lending on GONDI works, step by step, with its risks and fees. |
list_lending_opportunities | Collections borrowers take loans against, ranked by open principal, loans, offers or volume. |
get_collection_lending_stats | How much is lent against a collection (outstanding, all time and over 30 days), its open loans, repayment rate and the ranges of its loan terms. |
list_loan_offers | Active loan offers: principal, APR and duration; sorted by lowest APR, the cheapest loan a borrower can take. |
get_top_lenders | The leading lenders over 30, 90 or 180 days, with open principal, earnings, net APR and default rate. |
get_lender_returns | One lender's record per currency: principal lent, net profit, net APR, defaults and open positions. |
Borrowing
| Tool | What it answers |
|---|---|
list_borrower_loans | A borrower's open loans, counted and ranked: due dates, repayment due, and the renegotiation or market offers that could make them cheaper. |
list_borrowing_opportunities | The NFTs a wallet holds that are not in a loan, with the largest offer each can take today; NFTs sharing an offer come as one row, with how many it can fund. |
get_borrow_quote | How much one NFT can borrow right now: its largest offer and its cheapest-APR offer. |
get_buy_with_loan_quote | What buying a listed NFT with a loan costs: the upfront payment, the loan's terms and repayment, and the fee. |
Wallet
| Tool | What it answers |
|---|---|
get_wallet_holdings | What a wallet's NFTs are worth in ETH and USD, where it holds them, its most valuable collections, and what it owes as a borrower. |
Fees
The tools answer GONDI's marketplace fees, as of November 2026:
- A regular GONDI sale costs the seller 0.5% of the price, against OpenSea's 1.0% (OpenSea's rate since 2025-09-15).
- Buyers pay no GONDI fee: a GONDI listing costs its price, and a bidder on a regular bid pays exactly the bid.
- A stealth listing costs the seller 2.0%, and a stealth bid adds 0.5% on top of the bid, paid by the bidder, while its seller pays 0.5%.
- Buying with a loan adds 2.0% to the price, paid by the buyer. Selling an NFT that is collateral in a loan to repay it (sell and repay) costs the seller 2.0%.
- CryptoPunks pay no GONDI sale fee.
- Buying an OpenSea listing through GONDI costs the same as on OpenSea.
Example questions
- "What's the floor and the top bid on Pudgy Penguins?"
- "What's the top bid on Milady #1234, and what is it listed for?"
- "Show me the five cheapest CryptoPunks for sale."
- "What's the cheapest piece for sale by XCOPY?"
- "What did Fidenza sell for this week?"
- "How has the Pudgy Penguins floor moved over the last 90 days?"
- "What are the top NFT collections right now, and what's trending today?"
- "What is vitalik.eth's NFT wallet worth?"
- "How much can I borrow against Milady #1234?"
- "What would it cost to buy Azuki #42 with a loan?"
- "Should I sell my Pudgy Penguin or borrow against it?"
- "Where do I pay the lowest fees to sell a Fidenza, GONDI or OpenSea?"
- "If I accept the top bid on my Milady, what do I keep?"
- "Which of my loans expire this week?" (give your address, GONDI username or ENS name)
- "Which of my loans should I renegotiate?"
- "What can I borrow against the NFTs in vitalik.eth?"
- "What's the cheapest loan I can take on Azuki?"
- "What APR can I earn lending against Pudgy Penguins?"
- "Which collections are best to lend against?"
- "Who are the top lenders this month and what do they earn?"
- "What are mishark's lending returns?"
- "How does GONDI lending work and what are the risks?"
eval/questions.md has the list we check answers against,
so you can reproduce them.
Limits
- Read-only. No tool holds keys, signs or sends transactions. Answers link to the page on gondi.xyz where you act with your own wallet: buy, bid, borrow, repay, renegotiate or refinance.
- No API key. Requests are rate-limited per IP address.
- Live data. Answers come from GONDI's public data at the moment of the call.
- Not financial advice. Suggestions are based on market data only. Buying, borrowing and lending against NFTs carry risk: a loan not repaid by its expiry defaults and the borrower loses the NFT.
Report a wrong answer
If an assistant gives a wrong answer from GONDI data, or you need a tool that doesn't exist yet, open an issue. Include the question you asked and what the assistant answered.
Links
- Documentation: https://docs.gondi.xyz/gondi-v3/mcp-server/
- MCP Registry entry: https://registry.modelcontextprotocol.io/v0/servers?search=xyz.gondi
- Server card: https://www.gondi.xyz/.well-known/mcp/server-card.json
- GONDI: https://www.gondi.xyz