Linkit Documentation
E-commerce integration middleware — unified API for products, inventory, orders, and platform connections
Linkit Documentation
Linkit is e-commerce integration middleware. It connects delivery platforms, marketplaces, and AI services through a single REST API, letting you manage products, inventory, orders, and integrations from one place.
🤖 MCP Integration — Connect AI Assistants to Your API
New: Model Context Protocol Support
Linkit now speaks MCP. Point Claude, Cursor, Windsurf, or any MCP client at your Linkit instance and get instant access to 10 semantic API tools — zero setup, zero local installation. Your AI assistant can manage products, inventory, orders, and integrations by talking to your API directly.
One line of config is all you need:
{ "mcpServers": { "linkit": { "url": "https://linkit.works/api/v1/mcp" } } }📖 MCP Integration Guide
Full setup instructions for Claude Desktop, Cursor, Windsurf, and generic MCP clients. Includes tool catalog, resource list, example prompts, and troubleshooting.
🛠 10 Semantic Tools
API operations are grouped into domain-aware tools (manage_products, manage_orders, check_health, etc.) for efficient AI interaction.
📚 Built-in Documentation Resources
AI assistants can read the full Swagger spec, API overview, and tool catalog directly through MCP — no browser needed.
🤖 llms.txt
Machine-readable site manifest for LLMs. View online or download at /llms.txt.
Quick Start
API Explorer
Interactive API reference powered by your live OpenAPI spec. Try endpoints, inspect schemas, and generate client code.
Authentication
Set up Bearer tokens and API keys to start making requests.
Core Concepts
Products
Central product catalog with bilingual names, pricing, VAT, barcodes, and brand/category assignments.
Branches
Physical locations or stores. Adding a branch auto-generates one SKU per existing product.
SKUs
Per-branch inventory records (product × branch). Created automatically — manage stock and pricing here.
Orders
Unified order ingestion from any source with status tracking, analytics, and bulk operations.
Integrations
Connect external platforms (Salla, HungerStation, Noon, etc.) and sync data on demand or on schedule.
Bulk Operations
Process up to 1,000 records per request with create, update, or upsert modes and partial-failure handling.
Getting Started
1. Authenticate
All API requests require either a Bearer token or an API key. See Authentication for details.
curl -X GET "https://linkit.works/api/v1/products" \
-H "Authorization: Bearer your_token_here"2. Create Products and Branches
Products represent your catalog items. Branches represent physical locations. When you create a branch, Linkit auto-generates a SKU for every existing product at that branch.
3. Manage Inventory
Update stock levels and pricing through the SKUs API. SKUs are the intersection of a product and a branch.
4. Connect Integrations
Install apps from the App Store to sync with delivery platforms, e-commerce marketplaces, and AI services. Integrations run on a schedule or can be triggered via the Integrations API.
API Reference
Full endpoint documentation organized by resource:
API Overview
Base URL, request format, pagination, filtering, and error handling.
Categories
Hierarchical product categorization with unlimited nesting depth.
Brands
Brand management with product associations and bulk operations.
Generics
Generic medicine names for pharmaceutical catalogs.
Customers
Customer profiles, addresses, and lookup by email or phone.
Health and Telemetry
System status, runtime metrics, and monitoring endpoints.