@ada-diamonds/mcp
v1.0.0
Published
Official Ada Diamonds MCP server for local MCP clients: search live lab grown diamond inventory, engagement ring settings, fine jewelry, and buying guides from Claude Desktop, Cursor, and any stdio client.
Maintainers
Readme
@ada-diamonds/mcp
The official Ada Diamonds MCP server, packaged for local MCP clients. Search live lab grown diamond inventory, engagement ring settings, and fine jewelry, and read the diamond buying guides, from Claude Desktop, Cursor, VS Code, or any client that speaks MCP over stdio.
The server runs remotely at https://www.adadiamonds.com/mcp (Streamable HTTP, no credential needed). This package is a stdio bridge to it, built on mcp-remote; clients that support remote servers directly can skip the package and connect to the URL.
Use
Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json), and most stdio clients:
{
"mcpServers": {
"ada-diamonds": {
"command": "npx",
"args": ["-y", "@ada-diamonds/mcp"]
}
}
}Clients that support remote servers (Claude.ai connectors, Claude Code, VS Code, Cursor 1.0+):
{
"mcpServers": {
"ada-diamonds": {
"type": "streamable-http",
"url": "https://www.adadiamonds.com/mcp"
}
}
}npx @ada-diamonds/mcp --docs bridges the documentation server (/mcp/docs: search_docs, read_doc, list_docs) instead. Other arguments pass through to mcp-remote, e.g. --header "Authorization: Bearer <token>" to use an API key or OAuth token.
Tools
| Tool | What it does |
| --- | --- |
| search_diamonds | Live loose lab diamonds by shape, carat, price, color, clarity, cut; returns grading report numbers and product URLs |
| search_engagement_rings | Settings by center-stone shape, style, type, price (setting prices exclude the center diamond) |
| search_jewelry | Wedding bands, earrings, necklaces, bracelets, fashion rings |
| search_knowledge_base / read_article | Buying guides and knowledge base |
| get_company_info | Showrooms, hours, contact, remote consultations |
| request_consultation | Ask a jeweler to reach out (requires the appointments:write scope via OAuth) |
Every tool declares an input schema with described parameters and an output schema; the search tools also carry MCP Apps views that hosts such as Claude and ChatGPT render as interactive result cards.
Pricing model: an engagement ring is a setting plus a loose diamond, priced separately. Call search_engagement_rings and search_diamonds and add them. All prices are US dollars.
Elsewhere
- Documentation: https://www.adadiamonds.com/developers/mcp
- Server card: https://www.adadiamonds.com/.well-known/mcp/server-card.json
- Official MCP Registry:
com.adadiamonds/ada-diamonds - Smithery: https://smithery.ai/servers/adadiamonds/ada-diamonds
- REST API and SDKs:
@ada-diamonds/cli(npm),ada-diamonds(PyPI),github.com/adadiamonds/ada-go(Go)
License
MIT. Copyright Ada Diamonds, Inc.
