How to Use the J&T Express Malaysia MCP in Pydantic AI

Q: How do I register J&T Express Malaysia tools in Pydantic AI?

Use the MCPToolset constructor pointing to your Vinkius HTTP endpoint. Pass the toolset in the toolsets argument when initializing your Pydantic AI Agent to expose the MCP Server.

Q: Can my Pydantic AI agent cancel a shipment?

Yes, your agent can call cancelorder by passing the specific bill code. The tool returns a structured confirmation that Pydantic AI validates before proceeding with your MCP workflow.

Build type-safe J&T Express Malaysia shipping workflows using Pydantic AI for guaranteed runtime validation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect J&T Express Malaysia MCP to Pydantic AI

Create your Vinkius account to connect J&T Express Malaysia to Pydantic AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup J&T Express Malaysia with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Type-safe order creation with Pydantic AI

Never worry about sending malformed address data to the carrier. Your Pydantic AI agent validates each argument against strict schemas before calling `create_order` to book a parcel. If the agent attempts to pass an invalid postal code, the execution halts immediately with a clear validation error. This prevents api errors and guarantees that only clean data reaches the J&T Express Malaysia systems.

Strict schema validation for tracking and rates

Fetching shipping costs requires precise input parameters. This MCP Server lets your agent call `get_shipping_rates` with strict type checks on package weight and dimensions. When pulling tracking data via `track_order`, the returned JSON matches your Pydantic models exactly. You don't have to write custom parsing code to handle unexpected API responses.

Reliable location mapping across Malaysia

Guard against typos in city and district names. By calling `list_provinces` and `list_districts`, your agent builds a dynamic, validated list of delivery zones. By feeding this structured data into your agent's context, it can guide users to select valid shipping destinations. This eliminates shipping failures caused by mismatched regional codes.

Setup guide

Set up J&T Express Malaysia MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "jt-express-malaysia-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to J&T Express Malaysia tools.",
)

result = await agent.run("List recent J&T Express Malaysia transactions")
print(result.output)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by J&T Express Malaysia. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect J&T Express Malaysia now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about J&T Express Malaysia MCP in Pydantic AI

Use the `MCPToolset` constructor pointing to your Vinkius HTTP endpoint. Pass the toolset in the `toolsets` argument when initializing your Pydantic AI `Agent` to expose the MCP Server.

Pydantic AI will raise a validation error at runtime if the `get_order_details` payload deviates from the expected schema. This protects your application from silent failures and corrupt database records.

Yes, your agent can call `cancel_order` by passing the specific bill code. The tool returns a structured confirmation that Pydantic AI validates before proceeding with your MCP workflow.

Yes, the server integrates with Pydantic AI's async execution loop. This allows your agent to run tools like `get_waybill_image` and `track_order` concurrently for multiple shipments.

Your shipping rates, recipient phone numbers, and delivery addresses are processed entirely in memory. The connection uses ephemeral V8 isolates, meaning no sensitive logistics data is written to disk or stored by Vinkius.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript