Linnworks (E-commerce Ops) MCP Server for OpenAI Agents SDK 10 tools — connect in under 2 minutes
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Linnworks (E-commerce Ops) through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="Linnworks (E-commerce Ops) Assistant",
instructions=(
"You help users interact with Linnworks (E-commerce Ops). "
"You have access to 10 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Linnworks (E-commerce Ops)"
)
print(result.final_output)
asyncio.run(main())
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Linnworks (E-commerce Ops) MCP Server
Connect your Linnworks account to any AI agent and take full control of your multi-channel e-commerce inventory and order management through natural conversation.
The OpenAI Agents SDK auto-discovers all 10 tools from Linnworks (E-commerce Ops) through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Linnworks (E-commerce Ops), another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Order Orchestration — List all open orders across your integrated marketplaces (Amazon, Shopify, eBay) and retrieve detailed line items and shipping info directly from your agent
- Inventory Intelligence — Query specific product details by exact SKU, including weights, categories, and extended property mappings required for accurate listings
- Multi-Location Stock — Retrieve real-time stock levels across all your physical warehouses and virtual locations to identify shortages or surplus inventory
- Logistics Audit — List configured postal services, shipping methods, and carriers to understand your fulfillment network and cost structures
- Sales Channel Monitoring — Enumerate active sales channels and their integration statuses to ensure your multichannel synchronization is healthy
- Supplier & PO Management — List configured suppliers and monitor recent returns and refunds from the last 30 days to maintain supply chain visibility
The Linnworks (E-commerce Ops) MCP Server exposes 10 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect Linnworks (E-commerce Ops) to OpenAI Agents SDK via MCP
Follow these steps to integrate the Linnworks (E-commerce Ops) MCP Server with OpenAI Agents SDK.
Install the SDK
Run pip install openai-agents in your Python environment
Replace the token
Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com
Run the script
Save the code above and run it: python agent.py
Explore tools
The agent will automatically discover 10 tools from Linnworks (E-commerce Ops)
Why Use OpenAI Agents SDK with the Linnworks (E-commerce Ops) MCP Server
OpenAI Agents SDK provides unique advantages when paired with Linnworks (E-commerce Ops) through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Linnworks (E-commerce Ops) + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Linnworks (E-commerce Ops) MCP Server delivers measurable value.
Automated workflows: build agents that query Linnworks (E-commerce Ops), process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Linnworks (E-commerce Ops), another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Linnworks (E-commerce Ops) tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Linnworks (E-commerce Ops) to resolve tickets, look up records, and update statuses without human intervention
Linnworks (E-commerce Ops) MCP Tools for OpenAI Agents SDK (10)
These 10 tools become available when you connect Linnworks (E-commerce Ops) to OpenAI Agents SDK via MCP:
execute_custom_rpc
Example path: /api/Inventory/GetInventoryItemTitles. All Linnworks APIs are POST-based RPC. Refer to apps.linnworks.net/Api for the full endpoint list. Execute any custom fallback POST RPC method exposed by Linnworks API
get_inventory_item
Use this to check product details, pricing, weight, and category assignment for a specific product. Get Linnworks inventory item details by exact SKU
get_stock_level
Returns available, in-order, due, and minimum quantities per location. Get Linnworks stock levels across all locations by Item ID
list_categories
Returns category IDs, names, and parent-child hierarchy. Use to understand product organization and filter inventory. Get Linnworks active product grouping categories
list_channels
) and their properties via /api/Inventory/GetChannels. Returns channel ID, source name, subchannel info, and integration status. Get Linnworks active sales channel properties (Amazon, Shopify, etc)
list_locations
Returns location ID, name, address, and configuration settings for each warehouse. Get Linnworks explicitly configured inventory locations/warehouses
list_open_orders
Pass limit to control pagination. Returns order details including order IDs, customer info, shipping, and item lines. Get Linnworks open orders including lines and customer info
list_postal_services
Returns service names, carriers, tracking capabilities, and cost configuration. Get Linnworks explicitly configured postal services
list_returns
Returns return IDs, reason codes, refund amounts, order references, and processing status. Get Linnworks recent returns from the last 30 days
list_suppliers
Returns supplier names, codes, contact details, and currency settings. Get Linnworks configured purchase order suppliers
Example Prompts for Linnworks (E-commerce Ops) in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Linnworks (E-commerce Ops) immediately.
"List the last 10 open orders from Linnworks"
"Show me the stock levels for SKU 'CL-NV-001' across all locations"
"What sales channels are currently connected to our account?"
Troubleshooting Linnworks (E-commerce Ops) MCP Server with OpenAI Agents SDK
Common issues when connecting Linnworks (E-commerce Ops) to OpenAI Agents SDK through the Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Linnworks (E-commerce Ops) + OpenAI Agents SDK FAQ
Common questions about integrating Linnworks (E-commerce Ops) MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Connect Linnworks (E-commerce Ops) with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect Linnworks (E-commerce Ops) to OpenAI Agents SDK
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.