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. MCP-aware clients (Claude Desktop, ChatGPT MCP Connectors) sign in via OAuth 2.0 (MCP 2025-06-18 spec) — no manual token paste. REST clients use a Personal Access Token. Anonymous read access works out of the box.

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

MCP clients: OAuth 2.0 (automatic)

Claude Desktop and ChatGPT MCP Connectors auto-discover OAuth via the resource metadata endpoint on first connect. Your browser opens for sign-in and scope approval; the token is stored locally by the client (90-day lifetime). OAuth-issued tokens appear in Connected AI under the AI client's reported name (e.g. Claude Desktop, ChatGPT MCP Connector) — revoke there to force the client to re-authorize. PKCE S256 + dynamic client registration follow the MCP 2025-06-18 spec.

REST / Custom GPT: Personal Access Tokens

For ChatGPT Custom GPTs (free tier) or any REST integration, mint a PAT from Connected AI and use it as a Bearer token. 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.

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 (auto-OAuth)

{
  "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 MCP Connectors (Plus / Pro / Team)

Settings → Connectors → Add MCP server → https://mcp.thcstore.in/mcp

ChatGPT Custom GPT (free tier — REST + PAT)

OpenAPI URL: https://agent-api.thcstore.in/.well-known/ai-plugin.json
Auth: API Key → Bearer → paste a PAT from /account/connected-ai

Tool catalogue (111)

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

ops:alerts:read (1)

POST/v1/tools/alerts.recentalerts.recent

ops:backup:read (1)

POST/v1/tools/ops.backup.statusops.backup.status

ops:brands:read (5)

POST/v1/tools/ops.brand.kycPendingops.brand.kycPending
POST/v1/tools/ops.brand.ordersTodayops.brand.ordersToday
POST/v1/tools/ops.brand.settlementsops.brand.settlements
POST/v1/tools/ops.brand.topSkusops.brand.topSkus
POST/v1/tools/ops.brand.warehousesops.brand.warehouses

ops:cart:read (3)

POST/v1/tools/cart.abandon-infocart.abandon-info
POST/v1/tools/ops.cart.abandonedListops.cart.abandonedList
POST/v1/tools/ops.cart.byIdops.cart.byId

ops:comms:read (1)

POST/v1/tools/ops.comms.telegramAdminStatusops.comms.telegramAdminStatus

ops:coupons:issue (1)

POST/v1/tools/ops.coupons.couponIssueops.coupons.couponIssue

ops:coupons:read (2)

POST/v1/tools/ops.coupons.byIdops.coupons.byId
POST/v1/tools/ops.coupons.statsops.coupons.stats

ops:cron:read (2)

POST/v1/tools/ops.cron.healthops.cron.health
POST/v1/tools/ops.cron.pingops.cron.ping

ops:customers:read (5)

POST/v1/tools/ops.customers.addressesops.customers.addresses
POST/v1/tools/ops.customers.byIdops.customers.byId
POST/v1/tools/ops.customers.loyaltyops.customers.loyalty
POST/v1/tools/ops.customers.rxops.customers.rx
POST/v1/tools/ops.customers.walletops.customers.wallet

ops:doctors:read (4)

POST/v1/tools/ops.consultations.noshowops.consultations.noshow
POST/v1/tools/ops.doctor.appointmentsops.doctor.appointments
POST/v1/tools/ops.doctor.slotsops.doctor.slots
POST/v1/tools/ops.prescriptions.pendingops.prescriptions.pending

ops:email:test (1)

POST/v1/tools/ops.email.testSendops.email.testSend

ops:finance:read (7)

POST/v1/tools/ops.finance.gstSummaryops.finance.gstSummary
POST/v1/tools/ops.finance.hsnReportops.finance.hsnReport
POST/v1/tools/ops.finance.invoiceByIdops.finance.invoiceById
POST/v1/tools/ops.finance.revenueops.finance.revenue
POST/v1/tools/ops.finance.settlementListops.finance.settlementList
POST/v1/tools/ops.finance.tdsSummaryops.finance.tdsSummary
POST/v1/tools/ops.finance.walletDriftCheckops.finance.walletDriftCheck

ops:inventory:read (2)

POST/v1/tools/ops.inventory.lowStockops.inventory.lowStock
POST/v1/tools/ops.product.byIdops.product.byId

ops:marketing:read (3)

POST/v1/tools/ops.marketing.birthdayCouponStatsops.marketing.birthdayCouponStats
POST/v1/tools/ops.marketing.campaignSummaryops.marketing.campaignSummary
POST/v1/tools/ops.marketing.winbackAuditops.marketing.winbackAudit

ops:moderation:approve (1)

POST/v1/tools/ops.moderation.reviewApproveops.moderation.reviewApprove

ops:moderation:read (2)

POST/v1/tools/ops.returns.pendingops.returns.pending
POST/v1/tools/ops.reviews.pendingops.reviews.pending

ops:moderation:return (1)

POST/v1/tools/ops.moderation.returnApproveops.moderation.returnApprove

ops:n8n:trigger (1)

POST/v1/tools/ops.n8n.triggerops.n8n.trigger

ops:orders:cancel (1)

POST/v1/tools/ops.orders.orderCancelops.orders.orderCancel

ops:orders:read (4)

POST/v1/tools/ops.orders.byCustomerops.orders.byCustomer
POST/v1/tools/ops.orders.byIdops.orders.byId
POST/v1/tools/ops.orders.commissionops.orders.commission
POST/v1/tools/orders.recentorders.recent

ops:orders:refund (1)

POST/v1/tools/ops.orders.orderRefundops.orders.orderRefund

ops:pm2:logs (1)

POST/v1/tools/ops.pm2.logsops.pm2.logs

ops:pm2:restart (1)

POST/v1/tools/ops.pm2.restartops.pm2.restart

ops:pm2:status (1)

POST/v1/tools/ops.pm2.statusops.pm2.status

ops:schema:read (1)

POST/v1/tools/ops.schema.parityops.schema.parity

ops:seo:read (6)

POST/v1/tools/ops.seo.blogIdeaops.seo.blogIdea
POST/v1/tools/ops.seo.bounceCandidatesops.seo.bounceCandidates
POST/v1/tools/ops.seo.canonicalAuditops.seo.canonicalAudit
POST/v1/tools/ops.seo.keywordOppops.seo.keywordOpp
POST/v1/tools/ops.seo.sitemapCheckops.seo.sitemapCheck
POST/v1/tools/seo.gsc.summaryseo.gsc.summary

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