adadiamonds/agent-tools/ada-diamonds-mcp

Claude Code and agent skill by adadiamonds/agent-tools

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Connect to the Ada Diamonds MCP servers (catalog at https://www.adadiamonds.com/mcp, documentation at https://www.adadiamonds.com/mcp/docs) from Claude Code, Claude Desktop, Cursor, ChatGPT, or any Streamable HTTP MCP client, and use their tools and resources well. Use when setting up an MCP connection to Ada Diamonds, listing what the servers expose, or choosing between a tool call and a resource read.

Install

npx vskill@latest install adadiamonds/agent-tools/ada-diamonds-mcp

SKILL.md

The same SKILL.md was published earlier as adadiamonds/agent-tools/ada-diamonds-mcp.

Ada Diamonds MCP servers

Two Streamable HTTP servers, both anonymous for catalog and content. No OAuth handshake before tools/list.

ServerURLPurpose
ada-diamondshttps://www.adadiamonds.com/mcpLive catalog: diamonds, settings, jewelry, guides, company info, consultations
ada-diamonds-docshttps://www.adadiamonds.com/mcp/docsRead-only: the developer documentation itself (search_docs, read_doc, list_docs)

Registry name: com.adadiamonds/ada-diamonds. Server cards: https://www.adadiamonds.com/.well-known/mcp/server-card.json (also /mcp/server-card) and https://www.adadiamonds.com/.well-known/mcp/docs-server-card.json (also /mcp/docs/server-card). Registry manifest: https://www.adadiamonds.com/server.json. A plain GET on either server URL describes it.

This repository ships both in mcp.json (Agent Plugins format), so a client that installs the plugin gets them without further configuration.

Connect

Claude Code
bash
claude mcp add --transport http ada-diamonds https://www.adadiamonds.com/mcp
claude mcp add --transport http ada-diamonds-docs https://www.adadiamonds.com/mcp/docs

Or in .mcp.json at the project root:

json
{
"mcpServers": {
"ada-diamonds": { "type": "http", "url": "https://www.adadiamonds.com/mcp" },
"ada-diamonds-docs": { "type": "http", "url": "https://www.adadiamonds.com/mcp/docs" }
}
}
Claude Desktop and claude.ai

Either add it as a connector (Settings, Connectors, "Add custom connector", URL https://www.adadiamonds.com/mcp), or put it in claude_desktop_config.json (Settings, Developer, Edit Config) and restart:

json
{
"mcpServers": {
"ada-diamonds": { "type": "http", "url": "https://www.adadiamonds.com/mcp" }
}
}

No OAuth prompt appears for the public tools; request_consultation asks for consent when first used.

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

json
{
"mcpServers": {
"ada-diamonds": { "url": "https://www.adadiamonds.com/mcp" },
"ada-diamonds-docs": { "url": "https://www.adadiamonds.com/mcp/docs" }
}
}
ChatGPT

Settings, Connectors, "Create". Name it Ada Diamonds, MCP server URL https://www.adadiamonds.com/mcp, authentication "No authentication". Once saved, enable it in a chat from the tools menu (Developer mode is required for custom connectors on some plans).

Any other client

Streamable HTTP, JSON-RPC 2.0, Accept: application/json, text/event-stream. The server tolerates a plain application/json Accept. CORS is open for browser clients.

bash
# Initialize
curl -X POST https://www.adadiamonds.com/mcp \
-H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'
# List tools
curl -X POST https://www.adadiamonds.com/mcp \
-H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Tools on ada-diamonds

ToolDoesAuth
search_diamondsLive loose diamond inventory by shape, min_carat, max_carat, min_price, max_price, color, clarity, cut, sort, limit (1-50, default 10)none
search_engagement_ringsSettings by shape (center stone), style, type, min_price, max_price (setting only), q, limitnone
search_jewelryWedding bands, earrings, necklaces, bracelets, fashion rings by category, type, shape, min_price, max_price, q, limitnone
search_knowledge_baseFind published guides by query, limit (1-25, default 8)none
read_articleFull markdown of one guide by slugnone
get_company_infoContact details, showroom, hours, how buying worksnone
request_consultationBook a jeweler consultation: email (required), name, phone, topic, message, budget_usd, product_urlappointments:write via OAuth consent

All search tools are annotated readOnlyHint: true. request_consultation is non-destructive but writes; it cannot be used without the customer approving the scope on Ada's consent screen.

Prices returned by every tool are US dollars. Setting prices exclude the center diamond; pair search_engagement_rings with search_diamonds to quote a complete ring (see the ada-diamonds-shopping skill).

Resources on ada-diamonds

Read these once at the start of a session. They give the shape of the catalog and save several tool calls.

URIContents
ada://catalog/diamondsInventory summary by shape with carat and price ranges
ada://catalog/engagement-ringsSettings by style with price ranges
ada://catalog/jewelryJewelry by category
ada://content/knowledge-baseEvery published guide
ada://company/profileWho Ada Diamonds is, how buying works
ada://developers/apiThe API reference, condensed

All resources are text/markdown.

The docs server (ada-diamonds-docs)

A second, read-only, anonymous server at https://www.adadiamonds.com/mcp/docs that exposes the developer documentation itself, so a coding agent can look up an endpoint or a scope while writing an integration instead of scraping pages. It shares no state with the catalog server.

ToolDoes
search_docsFull-text search across the developer documentation; returns matching pages and sections with URLs
read_docThe markdown text of one documentation page
list_docsEvery documentation page with its title and URL

The same content is reachable as markdown at https://www.adadiamonds.com/developers (send Accept: text/markdown), https://www.adadiamonds.com/developers/llms.txt, and https://www.adadiamonds.com/mcp/llms.txt.

Tool-versus-resource guidance

  • Shopper asks "what can $5,000 buy": read ada://catalog/diamonds for ranges, then one search_diamonds call with a max_price.
  • Shopper asks about a specific stone: search_diamonds with tight min_carat/max_carat, or GET /api/v1/diamonds/{report} over REST. Do not rely on a result from earlier in the session; inventory turns over.
  • Questions about CVD, HPHT, the 4Cs, or certification: search_knowledge_base then read_article. Cite the article URL.
  • Questions about the business: get_company_info or ada://company/profile.

Rate limits and errors

The MCP server sits behind the same limiter as the REST API (120 requests/minute anonymous, 600 with a credential). Tool errors come back as isError: true text that says what to do next (for example, that a stone has sold and how to list what is available). Send Authorization: Bearer <key> with a self-serve key from POST https://www.adadiamonds.com/api/v1/keys to raise the limit; the public sandbox key ada_test_public_sandbox_key also works.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
2
7-day trend score
5

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/adadiamonds/agent-tools/ada-diamonds-mcp/badge)](https://verified-skill.com/skills/adadiamonds/agent-tools/ada-diamonds-mcp)

Something wrong with this skill or its page? Tell us.