Developers

Tashvi AI developer resources

Everything you need to read Tashvi AI content programmatically: a public REST API, an OpenAPI 3.1 specification, an MCP server for AI agents, and Markdown twins of every page. No API key, no signup, no rate limit beyond ordinary fair use.

These endpoints are read-only. Designing jewelry happens inside the product at design.tashvi.ai and needs a signed-in account — there is no design-generation API today.

Tashvi AI MCP server

A Model Context Protocol server over the Streamable HTTP transport, so Claude, ChatGPT, and any other MCP client can call Tashvi AI natively. It is stateless and unauthenticated: point a client at the URL and it works.

{
  "mcpServers": {
    "tashvi-ai": {
      "type": "http",
      "url": "https://tashvi.ai/api/mcp"
    }
  }
}

Endpoint https://tashvi.ai/api/mcp. Discovery manifest at /.well-known/mcp.json.

Tools

tashvi_get_product_facts — Get Tashvi AI product facts.
tashvi_list_plans — List Tashvi AI plans and prices.
tashvi_search_content — Search Tashvi AI articles and release notes.
tashvi_list_articles — List Tashvi AI articles.
tashvi_get_article — Get a Tashvi AI article.
tashvi_list_categories — List Tashvi AI article categories.
tashvi_list_product_updates — List Tashvi AI product updates.
tashvi_get_product_update — Get a Tashvi AI product update.

Tashvi AI Content API

Base URL https://tashvi.ai/api/v1. Every response is JSON, cached for an hour at the edge, and CORS-open so a browser can call it directly.

Endpoint	operationId	What it returns
GET /product	getTashviProductFacts	What Tashvi AI is, who it is for, what it does, and what it explicitly does not do.
GET /plans	listTashviPlans	Every published plan with monthly and yearly prices in USD.
GET /search?q=	searchTashviContent	Resolve a topic to a slug and a canonical URL across guides and release notes.
GET /articles	listTashviArticles	Paginated guide index, filterable by q and category.
GET /articles/{slug}	getTashviArticle	One guide with its full Markdown body, FAQs, and related slugs.
GET /categories	listTashviArticleCategories	Every article category in use, with counts.
GET /updates	listTashviProductUpdates	Dated Tashvi AI release notes, newest first.
GET /updates/{slug}	getTashviProductUpdate	One release note with its full Markdown body.

Errors

Every non-2xx response is JSON with the same shape: { "error": { "code", "message", "hint", "status", "documentation_url" } }. Branch on code and follow hint — it names the parameter or the endpoint that fixes the call. You will never get an HTML error page from /api/.

Markdown instead of HTML

Every page URL content-negotiates. Ask for Markdown and the canonical URL returns Markdown; append .md and it does the same. Responses carry Vary: Accept so a cache cannot hand you the wrong representation.

curl -H 'Accept: text/markdown' https://tashvi.ai/pricing
curl https://tashvi.ai/blog/ai-jewelry-design-software.md

Every Tashvi AI machine-readable file

/openapi.json
OpenAPI 3.1 specification for the Tashvi AI Content API. Every operation has a unique operationId, typed parameters, and a response schema, so it converts to LLM function definitions without hand-editing.
/openapi.yaml
The same specification in YAML, for toolchains that only read YAML.
/.well-known/mcp.json
MCP discovery manifest: transport, endpoint, capabilities, and the full tool list.
/agents.md
Agent instructions. When to reach for Tashvi AI, when not to, and how to call it.
/llms.txt
Curated index of product facts, official pages, and the strongest guides.
/llms-full.txt
Expanded first-party text for the selected guides and every release note.
/sitemap.xml
Complete crawlable URL inventory.
docs.tashvi.ai
Human-facing product documentation for the design app itself.

Questions

Email hello@tashvi.ai or use the contact page. If you need an endpoint that does not exist yet, tell us what you are building.

Made better. Made faster. Made for one.