Ada Diamonds agent tools

Official skills, MCP server list, and plugin manifest for AI agents that shop, integrate with, or check out at Ada Diamonds, the original lab diamond jeweler. The MCP server is listed on Smithery as adadiamonds/ada-diamonds and in the official MCP Registry.

Reading the catalog needs no credential and no account. Everything here points at public endpoints.

What is inside

Path	What
mcp-server/	@ada-diamonds/mcp on npm: npx -y @ada-diamonds/mcp bridges stdio clients (Claude Desktop, Cursor) to the remote server
cli/	@ada-diamonds/cli on npm: the official command-line client (npx @ada-diamonds/cli diamonds --shape Oval)
adadiamonds-cli/	adadiamonds-cli on npm: the same CLI under its unscoped name
python/	ada-diamonds on PyPI: the official Python client (pip install ada-diamonds)
skills/ada-diamonds-shopping/	Search live diamonds, settings, and jewelry; quote a complete ring correctly (setting plus loose diamond, USD)
skills/ada-diamonds-api/	REST API reference: every endpoint, auth, scopes, sandbox key, rate limits, errors, versioning, curl examples
skills/ada-diamonds-mcp/	Connect the MCP servers from Claude Code, Claude Desktop, Cursor, ChatGPT, or any client; tool and resource list
skills/ada-diamonds-commerce/	Agentic checkout: ACP checkout sessions, product feed, UCP discovery, sandbox vs live, order webhooks
plugin.json	Agent Plugins 1.0.0 manifest
mcp.json	The ada-diamonds and ada-diamonds-docs Streamable HTTP servers
scripts/validate.mjs	Validator for the manifest and skill frontmatter (CI runs it)

Install the skills

With the skills CLI (works for Claude Code, Codex, Cursor, Copilot, Gemini CLI, OpenCode, and more):

npx skills add adadiamonds/agent-tools            # pick skills and agents interactively
npx skills add adadiamonds/agent-tools --all      # every skill, every agent, no prompts
npx skills add adadiamonds/agent-tools -g -a claude-code   # globally, Claude Code only

One skill only:

npx skills add https://github.com/adadiamonds/agent-tools/tree/main/skills/ada-diamonds-shopping

Agent Plugins clients point at the repository root; plugin.json, skills/, and mcp.json are discovered from there.

Connect the MCP servers

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

Any other client:

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

Both are anonymous. request_consultation is the only tool that needs a credential (appointments:write, granted by the customer on Ada's OAuth consent screen).

Try the API in ten seconds

curl "https://www.adadiamonds.com/api/v1/diamonds?shape=Oval&min_carat=1&max_price=4000&sort=price_asc"
npx @ada-diamonds/cli diamonds --shape Oval --max-price 4000

A public sandbox key works for everyone and creates nothing: X-Ada-Api-Key: ada_test_public_sandbox_key.

The one rule

An engagement ring is a setting plus a loose diamond, priced separately, in US dollars. A setting's price_from excludes the center stone. Add the two to quote a complete ring, and re-check the stone before quoting it; inventory turns over continuously.

Validate

node scripts/validate.mjs

Links

• Developer documentation: https://www.adadiamonds.com/developers
• OpenAPI 3.1: https://www.adadiamonds.com/openapi.json
• Agent guide: https://www.adadiamonds.com/agents.md
• CLI: https://www.npmjs.com/package/@ada-diamonds/cli (alias https://www.npmjs.com/package/adadiamonds-cli)
• Python: https://pypi.org/project/ada-diamonds/
• Support: it@adadiamonds.com

MIT, Ada Diamonds, Inc.

Registry

The product server is published in the official MCP Registry as com.adadiamonds/ada-diamonds: https://registry.modelcontextprotocol.io/v0/servers/com.adadiamonds%2Fada-diamonds/versions/latest