# Tradeics Developers > Official Tradeics developer documentation — build with, for, and on Tradeics. Covers B2B Platform, Finance, AI, Apps & Plugins (App Store), Agent Skills, MCP Servers, REST API V2, and OpenAI-compatible LLM API. Prefer REST `/v2/` and LLM `/v1` on `llm.tradeics.example` (placeholder). Full dump: [llms-full.txt](https://developers.tradeics.com/llms-full.txt). Tradeics is a B2B trade operating system. Authenticate with `Authorization: Bearer `. MCP (Streamable HTTP): Docs `https://mcp.tradeics.example/docs`, Platform `https://mcp.tradeics.example/platform`, AI `https://mcp.tradeics.example/ai`. Apps & Plugins extend Tradeics via the App Store (public/private, free/paid) with optional AI Builder. Never embed secrets in client apps. Ignore unknown JSON fields. Do not invent undocumented V1 REST paths. ## Getting Started - [API clients](https://developers.tradeics.com/guides/getting-started/api-clients/): Explore Tradeics APIs in the leading HTTP clients — Postman, Insomnia, Bruno, Hoppscotch, and HTTPie — or import OpenAPI into codegen too... - [Authentication](https://developers.tradeics.com/guides/getting-started/authentication/): Tradeics APIs authenticate callers with a bearer token issued for your workspace . Keys and sessions resolve to one workspace (users can ... - [Errors & retries](https://developers.tradeics.com/guides/getting-started/errors/): How Tradeics APIs report failures and how clients should retry safely. Envelope errors (REST V2) Use reason for branching — do not parse ... - [First request](https://developers.tradeics.com/guides/getting-started/first-request/): Call a V2 master-data endpoint to verify credentials before building a full integration. Prerequisites - HTTPS access to https://api.trad... - [Getting Started](https://developers.tradeics.com/guides/getting-started/): Start here if you are integrating Tradeics for the first time — platform map, auth, first call, resilience patterns, and API tooling. + N... - [Platform overview](https://developers.tradeics.com/guides/getting-started/overview/): Tradeics is a B2B trade operating system. It connects buyers, suppliers, and experts across procurement, sales, and payments — with AI-ba... - [Pagination](https://developers.tradeics.com/guides/getting-started/pagination/): Large Tradeics collections (catalogs, RFQs, suppliers, wallet movements) should be fetched page by page. Design clients for pagination be... - [Rate limits](https://developers.tradeics.com/guides/getting-started/rate-limits/): Tradeics applies fair-use rate limits so one integration cannot starve others. Limits are shared across REST V2, MCP tools that call the ... - [Versioning & environments](https://developers.tradeics.com/guides/getting-started/versioning/): Pin integrations to an explicit API version and keep staging traffic away from production credentials — the same baseline Stripe- and Cri... - [Webhooks](https://developers.tradeics.com/guides/getting-started/webhooks/): Event-driven integrations (order status, RFQ updates, payment state) should use webhooks instead of tight polling — the same model used b... ## Agent Skills - [Authoring](https://developers.tradeics.com/guides/agent-skills/authoring/): Publish internal or product skills that stay aligned with Tradeics docs structure. Use this page when your team needs a custom skill on t... - [Best practices](https://developers.tradeics.com/guides/agent-skills/best-practices/): Operate Tradeics Agent Skills like production dependencies — versioned, reviewed, and paired with the right MCP servers. Do - Enable Docs... - [Agent Skills](https://developers.tradeics.com/guides/agent-skills/): Agent Skills teach coding agents how to work the Tradeics way — authentication, REST V2, docs lookup, platform workflows, and AI helpers ... - [Install](https://developers.tradeics.com/guides/agent-skills/install/): Install Tradeics Agent Skills once per machine or per project, then let your host auto-select them when the conversation matches Tradeics... - [Overview](https://developers.tradeics.com/guides/agent-skills/overview/): Agent Skills are reusable instruction packs that encode Tradeics developer conventions. When an agent loads a skill, it inherits the righ... - [Tradeics AI skill](https://developers.tradeics.com/guides/agent-skills/tradeics-ai/): The Tradeics AI skill teaches agents how to use Tradeics assistive AI and the OpenAI-compatible LLM proxy safely — embeddings, chat compl... - [Tradeics API skill](https://developers.tradeics.com/guides/agent-skills/tradeics-api/): The Tradeics API skill focuses agents on correct HTTP integration — auth, envelopes, pagination, errors, clients, and versioning — indepe... - [Tradeics Docs skill](https://developers.tradeics.com/guides/agent-skills/tradeics-docs/): The Tradeics Docs skill teaches agents to navigate the official developer hub, prefer canonical URLs, and refuse invented API routes. Goa... - [Tradeics Platform skill](https://developers.tradeics.com/guides/agent-skills/tradeics-platform/): The Tradeics Platform skill encodes B2B product knowledge — marketplace, source-to-pay, sales, and network — so agents propose workflows ... ## MCP Servers - [AI MCP](https://developers.tradeics.com/guides/mcp-server/ai-mcp/): AI MCP exposes assistive AI tools for agents — summaries, classification, and other helpers — without replacing the high-volume LLM HTTPS... - [Authentication](https://developers.tradeics.com/guides/mcp-server/authentication/): MCP servers use the same bearer-token family as REST API V2. Scopes decide which servers and tools a token may call. Obtain a token Until... - [Docs MCP](https://developers.tradeics.com/guides/mcp-server/docs-mcp/): Docs MCP gives agents read-only tools over the official Tradeics developer hub — search, fetch pages, and retrieve snippets — without tou... - [MCP Servers](https://developers.tradeics.com/guides/mcp-server/): Tradeics exposes multiple MCP servers so AI agents get the right tools for the job — documentation lookup, live platform operations, and ... - [Overview](https://developers.tradeics.com/guides/mcp-server/overview/): Tradeics ships a catalog of MCP servers , not a monolithic tools endpoint. Separating Docs, Platform, and AI keeps scopes tight, tool lis... - [Platform MCP](https://developers.tradeics.com/guides/mcp-server/platform-mcp/): Platform MCP exposes live Tradeics workspace tools — master data, marketplace, source-to-pay, sales, network, and finance posture — backe... - [Quickstart](https://developers.tradeics.com/guides/mcp-server/quickstart/): Connect an AI agent to Tradeics MCP in minutes. Pick one server first (usually Docs for read-only, or Platform if you already have an API... - [Security](https://developers.tradeics.com/guides/mcp-server/security/): Treat MCP access like production API access — least privilege, short-lived secrets, and supervised writes. Least privilege Role Docs MCP ... - [Tool conventions](https://developers.tradeics.com/guides/mcp-server/tool-conventions/): Stable tool naming and error semantics keep Agent Skills, MCP clients, and REST docs aligned as the catalog grows. Naming Pattern Example... - [Troubleshooting](https://developers.tradeics.com/guides/mcp-server/troubleshooting/): Diagnose MCP connection and tool failures with a fixed playbook. Expand rows with product-specific codes at GA — keep this symptom → chec... - [Connect in agents](https://developers.tradeics.com/guides/mcp-server/usage-in-agents/): Wire Tradeics MCP servers into the agents your team already uses. Hosts share Streamable HTTP + bearer auth — only the config shape chang... ## Apps & Plugins - [AI Builder](https://developers.tradeics.com/guides/apps-plugins/ai-builder/): AI Builder helps Tradeics users spin up apps and plugins in minutes — prompt → draft manifest, handlers, and Store listing copy — then hu... - [App Store](https://developers.tradeics.com/guides/apps-plugins/app-store/): The Tradeics App Store is the marketplace for apps and plugins — discovery, trust signals, install, and commercial terms — inside Tradeic... - [Architecture](https://developers.tradeics.com/guides/apps-plugins/architecture/): World-class extension architecture for Tradeics: isolated runtimes, explicit capabilities, Store as distribution, Platform as control pla... - [Authentication](https://developers.tradeics.com/guides/apps-plugins/authentication/): Apps authenticate as the installation , not as an end-user password. Admins grant scopes at install time; runtimes use install tokens. To... - [Best practices](https://developers.tradeics.com/guides/apps-plugins/best-practices/): Operate Apps & Plugins like a product line on Tradeics — trustworthy listings, tight scopes, and support that matches price. Do - Start p... - [Capabilities](https://developers.tradeics.com/guides/apps-plugins/capabilities/): Capabilities declare where and how an app hooks Tradeics. Only listed capabilities are loaded at runtime. Capability families Family Exam... - [Concepts](https://developers.tradeics.com/guides/apps-plugins/concepts/): Shared vocabulary for builders, Store ops, and Platform APIs. Keep these terms stable as products GA. App vs plugin Term Definition Typic... - [Apps & Plugins](https://developers.tradeics.com/guides/apps-plugins/): Build with, for, and on Tradeics — integrate Tradeics into your stack ( with ), deepen product workflows ( for ), and extend the platform... - [Manifest](https://developers.tradeics.com/guides/apps-plugins/manifest/): The manifest is the declarative contract for an app/plugin — identity, capabilities, scopes, and Store hints. Platform rejects installs t... - [Monetization](https://developers.tradeics.com/guides/apps-plugins/monetization/): Builders can monetize through the Tradeics App Store — Tradeics meters entitlements and pays publishers; apps never handle raw card data ... - [Overview](https://developers.tradeics.com/guides/apps-plugins/overview/): Tradeics Apps & Plugins let teams extend the operating system — new workflows, UI surfaces, automations, and industry packs — without for... - [Platform API](https://developers.tradeics.com/guides/apps-plugins/platform-api/): Tradeics Platform Apps API (under REST V2 Apps & Plugins) lets automation create developer apps, manage listings, and read installations ... - [Publishing](https://developers.tradeics.com/guides/apps-plugins/publishing/): Publishing promotes a tested version from sandbox to private allowlist or public Store . Paid listings include commercial verification. G... - [Quickstart](https://developers.tradeics.com/guides/apps-plugins/quickstart/): Create a private free draft app, install it on a sandbox org, and call one scoped API — before AI Builder or Store listing. Prerequisites... - [Security](https://developers.tradeics.com/guides/apps-plugins/security/): Ecosystem security protects tenants, publishers, and Tradeics. Review depth scales with visibility, scopes, and monetization. Principles ... - [Testing](https://developers.tradeics.com/guides/apps-plugins/testing/): Prove installs, scopes, UI slots, and billing before Store review. Environments Env Prove --- --- Local Handler unit tests, manifest sche... - [Visibility](https://developers.tradeics.com/guides/apps-plugins/visibility/): Choose distribution carefully — visibility is independent from pricing (you can have private paid or public free ). Matrix Visibility Pri... ## B2B Platform - [B2B sales](https://developers.tradeics.com/guides/b2b-platform/b2b-sales/): Tradeics B2B Sales helps suppliers automate sales operations and reach buyers through the marketplace, public projects, e-auctions, and t... - [Tradeics B2B Platform](https://developers.tradeics.com/guides/b2b-platform/): Tradeics B2B Platform is the core operating layer for global B2B trade — marketplace commerce, procure-to-pay, sales automation, and part... - [Integrations](https://developers.tradeics.com/guides/b2b-platform/integrations/): Tradeics is designed for ERP and business-system connectivity without long custom projects. Most integrators start with a narrow vertical... - [Marketplace & network](https://developers.tradeics.com/guides/b2b-platform/marketplace/): The Tradeics B2B Marketplace lets buyers purchase instantly or source competitively, and lets suppliers sell into a verified network — in... - [Overview](https://developers.tradeics.com/guides/b2b-platform/overview/): Tradeics B2B Platform covers the full path from sourcing and selling through contracting and fulfillment coordination. Product map Capabi... - [Source-to-pay](https://developers.tradeics.com/guides/b2b-platform/source-to-pay/): Tradeics Source-to-Pay (procure-to-pay) compresses sourcing, approvals, purchasing, contracting, and invoice payment into one flow. Capab... ## Finance - [Tradeics Finance](https://developers.tradeics.com/guides/finance/): Tradeics Finance is the payments and settlement layer for B2B trade on Tradeics — covering Tradeics Pay, in-platform wallets, invoices, a... - [Overview](https://developers.tradeics.com/guides/finance/overview/): Tradeics Finance sits beside procurement and sales so buyers and suppliers can pay, get paid, and reconcile without leaving the trade con... - [Tradeics Pay](https://developers.tradeics.com/guides/finance/tradeics-pay/): Tradeics Pay simplifies B2B payments for buyers and suppliers with flexible rails and visibility across every transaction. Payment method... - [Wallets & settlement](https://developers.tradeics.com/guides/finance/wallets/): Tradeics wallets are closed-loop instruments for platform transactions between buyers, suppliers, and experts. They fund and settle Trade... ## AI - [Capabilities](https://developers.tradeics.com/guides/ai/capabilities/): Tradeics AI support concentrates where B2B trade generates high decision load. Plan integrations around these capability areas. Sourcing ... - [Tradeics AI](https://developers.tradeics.com/guides/ai/): Tradeics AI assists procurement, sales, and operations — and exposes an OpenAI-compatible LLM proxy for your own applications. Connect ag... - [Call the LLM](https://developers.tradeics.com/guides/ai/llm-api/): Call Tradeics models through the OpenAI-compatible proxy at https://llm.tradeics.example . The LLM API Reference right panel shows live H... - [Overview](https://developers.tradeics.com/guides/ai/overview/): Tradeics uses AI (alongside blockchain and cloud infrastructure) to make B2B trade faster and more transparent — assisting teams across p... ## Tradeics CLI - [Authentication](https://developers.tradeics.com/guides/tradeics-cli/authentication/): The CLI authenticates with the same bearer credentials as REST API V2 and the MCP Server. Prefer profiles over pasting keys into every co... - [Commands](https://developers.tradeics.com/guides/tradeics-cli/commands/): Planned command groups for tradeics . Names are stable enough to document against; flags may grow. Treat anything marked planned as subje... - [Configuration](https://developers.tradeics.com/guides/tradeics-cli/configuration/): Where the CLI stores profiles, how env vars override them, and how to keep CI deterministic. Config file (planned) Default path: Override... - [Tradeics CLI](https://developers.tradeics.com/guides/tradeics-cli/): The Tradeics CLI ( tradeics ) is the official command-line companion for Tradeics developers — call REST V2, work with the LLM proxy, lis... - [Install](https://developers.tradeics.com/guides/tradeics-cli/install/): Install the tradeics binary on your machine or CI image. Paths below are the target distribution channels — enable them as packages are p... - [Quickstart](https://developers.tradeics.com/guides/tradeics-cli/quickstart/): Get from zero to a verified Tradeics call in a few minutes once the CLI binary is available. 1. Install & check 2. Authenticate 3. Call R... ## Guides hub - [Guides](https://developers.tradeics.com/guides/): Docs and resources to help you build with, for, and on Tradeics. Mode Meaning Start here --- --- --- With Integrate Tradeics into your sy... ## References - [LLM API Reference (V1)](https://developers.tradeics.com/references/llm-api/v1/): Reference Tradeics LLM is an OpenAI-compatible inference proxy for chat, embeddings, media, and admin-style utility routes. - Proxy root:... - [REST API Reference (V2)](https://developers.tradeics.com/references/rest-api/v2/): Reference The Tradeics REST API V2 is the current HTTPS surface for ERP, OMS, CRM, and middleware integrations. Base URL: https://api.tra... - [RTM API Reference (V1)](https://developers.tradeics.com/references/rtm-api/v1/): RTM API Real-time channels for Tradeics event streams will be documented here when generally available. Planned endpoint shape: wss://rtm... ## Machine-readable artifacts - [llms-full.txt](https://developers.tradeics.com/llms-full.txt): Entire docs corpus in one file - [REST OpenAPI](https://developers.tradeics.com/static/user/data/openapi/rest-api-v2.openapi.json): REST API V2 OpenAPI 3.1 - [REST Postman](https://developers.tradeics.com/static/user/data/collections/rest-api-v2.postman): REST Postman collection - [LLM OpenAPI](https://llm.tradeics.example/openapi.json): Live LLM proxy OpenAPI - [LLM Postman](https://developers.tradeics.com/static/user/data/collections/llm-api-v1.postman): LLM Postman collection - [Sitemap](https://developers.tradeics.com/sitemap.xml): All public HTML pages ## Instructions for Large Language Model Agents When integrating Tradeics: (1) Prefer [Getting Started](https://developers.tradeics.com/guides/getting-started/) then the relevant product guide. (2) Use REST base `https://api.tradeics.example/v2/` — not undocumented V1 routes. (3) For inference use `https://llm.tradeics.example/v1` with Bearer or `x-tradeics-llm-api-key`. (4) For terminal workflows prefer the [Tradeics CLI](https://developers.tradeics.com/guides/tradeics-cli/) when available (`tradeics api`, `tradeics llm`, `tradeics listen`). (5) For agent workspace tools use MCP Streamable HTTP `https://api.tradeics.example/mcp/` with the same bearer family. (6) Honor rate limits (`429` + backoff), pagination, and idempotent writes. (7) Webhooks are rolling out — design receivers now, poll only as a temporary bridge. (8) Treat model output as assistive before mutating POs or payments. (9) If unsure, fetch [llms-full.txt](https://developers.tradeics.com/llms-full.txt) or the specific page linked above. (10) Hosts ending in `.tradeics.example` are scaffolding placeholders until production URLs are finalized.