GONDI

Live NFT prices, bids, listings, sales, and lending and borrowing data from the GONDI marketplace.

Gehosteter MCP-Server

npx add-mcp 'https://api.gondi.xyz/mcp'

Installiert in Claude Code, Codex, Cursor und mehr

Dokumentation

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

URLhttps://api.gondi.xyz/mcp
TransportStreamable HTTP
AuthenticationNone: no API key, no wallet
AccessRead-only: it never signs or sends transactions
MCP Registryxyz.gondi/mcp

Setup

Claude (claude.ai and Claude Desktop)

  1. Open Customize → Connectors.
  2. Select + Add, then Add custom connector.
  3. Name it GONDI, enter https://api.gondi.xyz/mcp as the URL and select Continue.
  4. Choose No sign in under Authentication, then Add.
  5. 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

Add the GONDI MCP server to 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

ToolWhat it answers
search_gondiCollections, artists, NFTs and users matching a name, each with its slug or address, chain and GONDI page.

Market

ToolWhat it answers
get_collection_marketA 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_marketOne 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_saleThe cheapest NFTs for sale from a collection or by an artist, with the page to buy each.
list_recent_salesThe 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_historyHow a collection's floor moved over 7 to 365 days, one point a day, with the change in percent.
list_top_collectionsThe 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

ToolWhat it answers
get_lending_market_overviewThe whole lending market in USD: open principal, interest paid and accruing, volume and APRs of new loans.
get_supported_marketsThe chains and currencies GONDI lends in, the loan contract on each chain, accepted durations and the protocol fee.
get_lending_guideHow lending on GONDI works, step by step, with its risks and fees.
list_lending_opportunitiesCollections borrowers take loans against, ranked by open principal, loans, offers or volume.
get_collection_lending_statsHow 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_offersActive loan offers: principal, APR and duration; sorted by lowest APR, the cheapest loan a borrower can take.
get_top_lendersThe leading lenders over 30, 90 or 180 days, with open principal, earnings, net APR and default rate.
get_lender_returnsOne lender's record per currency: principal lent, net profit, net APR, defaults and open positions.

Borrowing

ToolWhat it answers
list_borrower_loansA borrower's open loans, counted and ranked: due dates, repayment due, and the renegotiation or market offers that could make them cheaper.
list_borrowing_opportunitiesThe 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_quoteHow much one NFT can borrow right now: its largest offer and its cheapest-APR offer.
get_buy_with_loan_quoteWhat buying a listed NFT with a loan costs: the upfront payment, the loan's terms and repayment, and the fee.

Wallet

ToolWhat it answers
get_wallet_holdingsWhat 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

License

MIT