GemstoneAI

com.gemstoneaiappPublished by gemstoneaiapp.comOfficial publisherv1.0.0Updated Nov 1, 2026

Analyze jewelry photos, see comparable listings and sales, and save the piece to a collection.

VerifiedStreamable HTTPWeb executableBusiness & CommerceMedia & Design

Overview

AI-generated overview

Hosted remote MCP server that lets an assistant analyze jewelry photos, show comparable listings and sales, and save pieces to a GemstoneAI collection.

What you can do
  • Analyze 1 to 5 photos of one jewelry piece for a preliminary identification with alternatives, unknowns and next evidence
  • Check the status or result of a running analysis
  • Find photographed comparable listings and sales with source, link, price, price type and differences from the piece
  • Save an analyzed piece to the signed-in person's collection and return a link that opens it in the app
When to use it
Useful when someone wants help identifying a piece of jewelry they own from photos, wants market context from comparable listings and sales, or wants the piece stored in their GemstoneAI collection for later use in the app.
Requirements
A remote Streamable HTTP endpoint; nothing to install. OAuth 2.1 sign-in with the email used in the GemstoneAI app (a new email gets a free account). Each analysis uses a scan from that account's plan, and pilot accounts have daily evaluation limits.
Before you install
Sign-in grants access to the person's GemstoneAI account and collection. Analyses consume plan scans, though repeating the same photos or idempotency key is not charged twice. Photos are uploaded and kept in the account, with location data removed. Results are preliminary photo-based analyses, not appraisals, and do not establish authenticity, treatment, origin or value. Saving writes to the collection.

Installation

In SourceWeft

  1. Open GemstoneAI in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.gemstoneaiapp%2Fgemstoneai/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "gemstoneai": {
      "type": "http",
      "url": "https://api.gemstoneaiapp.com/mcp"
    }
  }
}

README

GemstoneAI for Agents

GemstoneAI is a hosted remote MCP server that lets an AI assistant help someone with a piece of jewelry they own. The assistant can:

  • analyze 1 to 5 photos of the piece and give a preliminary identification, with its alternatives, unknowns and the evidence that would settle them
  • show photographed comparable listings and sales, each labelled as an asking price or a realized sale
  • save the piece to the person's GemstoneAI collection, so it opens in the GemstoneAI app on their phone
https://api.gemstoneaiapp.com/mcp

There is nothing to install or run. Product page: gemstoneaiapp.com/agents.

Connect

Add the URL as a remote (Streamable HTTP) MCP server in any client that supports one. The client discovers sign-in on its own. The person signs in with the email they use in the GemstoneAI app, so the collection is the same; a new email gets a free account. Each new analysis uses a scan from that account's plan, the same as in the app.

Claude Code, as a plugin (adds the server and a jewelry-research skill):

/plugin marketplace add Iveye-Inc/gemstoneai-agents/plugin install gemstoneai@gemstoneai

Claude Code, server only:

bash
claude mcp add --transport http gemstoneai https://api.gemstoneaiapp.com/mcp

Then run /mcp in Claude Code to sign in.

Other clients (Claude on the web and desktop, ChatGPT developer mode, Cursor, VS Code, MCP Inspector): add a remote MCP server with the URL above and sign in when prompted.

Client support is listed on the product page. A client is marked tested only after the full journey (photo, analysis, comparables, save, reopen in the app) has passed in it.

Tools

ToolWhat it doesAnnotations
analyze_jewelryPreliminary analysis of 1 to 5 photos of one piece. Takes photos (attached files) or image_urls (public https), and an optional idempotency_key. With no photos it returns an upload link the person opens on their phone.writes, not destructive, idempotent, open world
get_jewelry_analysisStatus or completed result of an analysis. Waits up to about 40 seconds while it is processing.read-only
find_jewelry_comparablesPhotographed market listings and sales with source, link, price, price type, date found and the material differences from this piece.read-only, open world
save_collection_itemSaves the analyzed piece to the signed-in person's collection and returns a link that opens it in the app.writes, not destructive, idempotent

Results never carry numeric confidence. Uncertainty comes as alternatives, unknowns and next evidence. When GemstoneAI's own reads disagree about what the stone is, price context is withheld with the reason. When no priced comparables are found, the answer is "none found", never a value of zero.

Protocol and authentication

  • Streamable HTTP, stateless, JSON responses. Initialize-based clients (protocol 2024-11-05 to 2025-11-25) and 2026-07-28 clients are supported.
  • OAuth 2.1 with PKCE (S256). Discovery: /.well-known/oauth-protected-resource/mcp and /.well-known/oauth-authorization-server on api.gemstoneaiapp.com.
  • Clients register with Client ID Metadata Documents or dynamic client registration. Loopback redirects may use any port.
  • Tokens are bound to one person, one client and this server (RFC 8707). Access tokens last an hour; refresh tokens rotate.
  • Scopes: jewelry:analyze and collection:write.

Latency and limits

  • An analysis typically takes 20 to 45 seconds. analyze_jewelry waits up to about 40 seconds, then returns processing with a retry interval. Comparables usually follow within a minute.
  • Repeating the same photos, or the same idempotency_key, returns the same analysis and is not charged twice.
  • During the pilot there are daily evaluation limits per account and per integration. Developers can request pilot access on the product page.

What it is not

Results are preliminary analyses from photographs. They are not appraisals and do not establish authenticity, treatment, origin or certified value. The server never buys, sells, lists or contacts anyone, and it saves to a collection only when asked.

Privacy

Photos are used to analyze the piece and are kept with it in the person's GemstoneAI account, like a scan in the app. Location data is removed from every photo. See the Privacy Policy and Terms.

Repository layout

  • .claude-plugin/marketplace.json, plugins/gemstoneai/: the Claude Code plugin (MCP server config and the jewelry-research skill)
  • openai/: the ChatGPT plugin package source; python scripts/build_openai_zip.py builds the ZIP
  • server.json: the entry in the official MCP Registry, published with scripts/publish_registry.py

Support

[email protected]

Source: README.md at commit 9b252a8

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestOct 10, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.