Agent Framework

Connect THC Store to your AI

THC Store India publishes a REST API, an MCP (Model Context Protocol) server, and a chat endpoint that any LLM — Claude, ChatGPT, Cursor, or your own agent — can call. Anonymous read access works out of the box. Authenticated tools (cart, checkout, account) require a Personal Access Token.

Three ways to connect

REST

JSON over HTTPS. Use it from any language or framework that speaks HTTP.

OpenAPI spec

MCP

Model Context Protocol. Best for Claude Desktop, Cursor, and other MCP-aware clients.

https://mcp.thcstore.in/mcp

Chat

A managed conversational front-door (PAT-gated). Good when you want THC Store to handle tool routing for you.

https://chat.thcstore.in/chat

Authentication

Today: Personal Access Tokens

Sign in to your THC Store account and visit Connected AI to mint a Personal Access Token (PAT). Use it as a Bearer token on REST or MCP. Each PAT can be scoped to specific tools (e.g. cart:write, orders:read).

Anonymous (tier-0) reads — product search, blog, doctor list, pincode resolve — work with no PAT and are IP rate-limited.

Coming in v2.1: OAuth device-code flow. Your agent will be able to ask the user to authorise scopes from a phone in 60 seconds — no manual PAT paste needed.

Code samples

curl — anonymous tier-0 search

curl -X POST https://agent-api.thcstore.in/v1/public/searchProducts \
  -H 'Content-Type: application/json' \
  -d '{"args":{"query":"ashwagandha","limit":3}}'

curl — authenticated tool call (PAT required)

curl -X POST https://agent-api.thcstore.in/v1/tools/addToCart \
  -H 'Authorization: Bearer thc_pat_xxx' \
  -H 'Content-Type: application/json' \
  -d '{"args":{"productId":1,"quantity":1}}'

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "thc-store": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.thcstore.in/mcp"]
    }
  }
}

Cursor — mcp.json

{
  "mcpServers": {
    "thc-store": {
      "url": "https://mcp.thcstore.in/mcp"
    }
  }
}

ChatGPT GPT Action manifest

OpenAPI URL: https://agent-api.thcstore.in/v1/openapi.json
Auth: Bearer token (Personal Access Token from /account/connected-ai)

Tool catalogue (52)

Live from https://agent-api.thcstore.in/v1/openapi.json — refreshes hourly.

account:read (3)

POST/v1/tools/getAddressesgetAddresses
POST/v1/tools/getLoyaltyPointsgetLoyaltyPoints
POST/v1/tools/getWalletBalancegetWalletBalance

auth (18)

GET/v1/auth/session/{sessionId}/pollPoll an OAuth session for the redeemed PAT
POST/v1/auth/session/startStart an OAuth session (auth-link / device-code)
POST/v1/tools/public.checkStockpublic.checkStock
POST/v1/tools/public.getBlogPostpublic.getBlogPost
POST/v1/tools/public.getBrandProfilepublic.getBrandProfile
POST/v1/tools/public.getCategoriespublic.getCategories
POST/v1/tools/public.getDoctorProfilepublic.getDoctorProfile
POST/v1/tools/public.getDosageGuidepublic.getDosageGuide
POST/v1/tools/public.getProductpublic.getProduct
POST/v1/tools/public.getProductClaimpublic.getProductClaim
POST/v1/tools/public.getStateCitypublic.getStateCity
POST/v1/tools/public.listBrandspublic.listBrands
POST/v1/tools/public.listDoctorspublic.listDoctors
POST/v1/tools/public.listServiceablePincodespublic.listServiceablePincodes
POST/v1/tools/public.resolvePincodepublic.resolvePincode
POST/v1/tools/public.searchBlogpublic.searchBlog
POST/v1/tools/public.searchProductspublic.searchProducts
POST/v1/tools/whoamiwhoami

cart:read (2)

POST/v1/tools/getCartgetCart
POST/v1/tools/getCartTotalsgetCartTotals

cart:write (5)

POST/v1/tools/addToCartaddToCart
POST/v1/tools/applyCouponapplyCoupon
POST/v1/tools/clearCartclearCart
POST/v1/tools/removeFromCartremoveFromCart
POST/v1/tools/updateQuantityupdateQuantity

catalog:read (5)

POST/v1/tools/checkStockcheckStock
POST/v1/tools/getCategoriesgetCategories
POST/v1/tools/getProductgetProduct
POST/v1/tools/getRxRequiredForgetRxRequiredFor
POST/v1/tools/searchProductssearchProducts

consultations:read (5)

POST/v1/tools/getDoctorAvailabilitygetDoctorAvailability
POST/v1/tools/getDoctorProfilegetDoctorProfile
POST/v1/tools/joinAppointmentVideojoinAppointmentVideo
POST/v1/tools/listDoctorslistDoctors
POST/v1/tools/listMyAppointmentslistMyAppointments

consultations:stage (2)

POST/v1/tools/confirmStagedConsultationconfirmStagedConsultation
POST/v1/tools/stageConsultationstageConsultation

consultations:write (1)

POST/v1/tools/cancelAppointmentcancelAppointment

orders:read (3)

POST/v1/tools/getOrdergetOrder
POST/v1/tools/getOrderTrackinggetOrderTracking
POST/v1/tools/listOrderslistOrders

orders:stage (3)

POST/v1/tools/cancelStagedOrdercancelStagedOrder
POST/v1/tools/confirmStagedOrderconfirmStagedOrder
POST/v1/tools/stageOrderstageOrder

prescriptions:read (1)

POST/v1/tools/listMyPrescriptionslistMyPrescriptions

prescriptions:write (3)

POST/v1/tools/linkPrescriptionToOrderlinkPrescriptionToOrder
POST/v1/tools/requestPrescriptionUploadrequestPrescriptionUpload
POST/v1/tools/submitPrescriptionsubmitPrescription

recos:read (1)

POST/v1/tools/getPersonalizedRecommendationsgetPersonalizedRecommendations