Order Status Agent via MCP

Expose your Order API as an MCP tool

Create a lightweight MCP server that wraps your existing Order Management REST API. You define one tool called get_order_status that accepts an order ID and returns shipping status, estimated delivery, and tracking info.

// mcp-server/tools/order-status.ts
{
  name: "get_order_status",
  description: "Retrieves real-time status for a customer order",
  inputSchema: {
    type: "object",
    properties: {
      order_id: { type: "string", description: "The order ID e.g. ORD-5521" }
    },
    required: ["order_id"]
  }
}

Host your MCP server

Deploy your MCP server on your own infrastructure (Node.js, Python, .NET — any language works). It just needs to be reachable by SentientOne over HTTPS. Your internal API credentials never leave your environment.

Register the MCP server in SentientOne

In the SentientOne dashboard, navigate to MCP Connections and add your server URL. SentientOne will auto-discover your available tools and make them available to any agent you assign them to.

Create the Order Status Agent

In the SentientOne dashboard, create a new agent. Give it a name like 'Customer Order Assistant' and write a focused system prompt that defines its role.

System Prompt:
You are a friendly customer support assistant for [Your Brand].
Your job is to help customers check the status of their orders.
Always use the get_order_status tool to retrieve live data.
If an order is not found, apologise and suggest contacting support.
Keep responses concise and friendly.

Attach the MCP connection

In the agent's Tools section, select your MCP server. The agent will now have access to get_order_status. The AI automatically decides when to call it based on the customer's message.

Choose a model and set parameters

Select your preferred model (GPT-4o, Claude 3.5 Sonnet, etc.) and configure temperature (recommend 0.3 for factual queries). Save the agent — it's now live and callable via API.

Get your API key

In SentientOne, go to Settings → API Keys and generate a key for your Order Status Agent. Keep this secure — it authenticates your app to the agent.

One POST request from your app

Replace your existing support widget or chat interface with a single API call:

// From your React, Flutter, Python, or any app
const response = await fetch("https://app.sentientone.ai/api/chat", {
  method: "POST",
  headers: {
    "X-Agent-Id": "YOUR_AGENT_ID",
    "X-App-Key": "YOUR_APP_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    message: userMessage,
    sessionId: customer.id  // maintains conversation history
  })
});
const { reply } = await response.json();

Display the response

Render the reply text in your UI. The response is plain text — style it however you like. For real-time streaming (token by token), use the /api/chat/stream endpoint instead.