Quickstart

from fastapi import FastAPI, Request

app = FastAPI()

TOOLS = [{
    "name": "search_products",
    "description": "Look up a design by its design ID and return price and stock.",
    "inputSchema": {
        "type": "object",
        "properties": {"query": {"type": "string", "description": "Design ID, e.g. MC2045"}},
        "required": ["query"],
    },
}]

@app.post("/mcp")
async def mcp(request: Request):
    body = await request.json()
    method, rid = body.get("method"), body.get("id")

    if method == "initialize":
        result = {
            "protocolVersion": "2025-06-18",
            "serverInfo": {"name": "acme-commerce", "version": "1.0"},
            "capabilities": {"tools": {}},
        }
    elif method == "tools/list":
        result = {"tools": TOOLS}
    elif method == "tools/call":
        params = body.get("params") or {}
        # Authenticate: the token identifies WHICH workspace is calling.
        # tenant = tenant_for(request.headers.get("authorization"))
        query = (params.get("arguments") or {}).get("query", "")
        result = {"content": [{"type": "text",
                               "text": f"{query}: georgette, 5 colours, Rs 1,450"}]}
    else:
        return {"jsonrpc": "2.0", "id": rid, "result": {}}

    return {"jsonrpc": "2.0", "id": rid, "result": result}

import express from "express";

const app = express();
app.use(express.json());

const TOOLS = [{
  name: "search_products",
  description: "Look up a design by its design ID and return price and stock.",
  inputSchema: {
    type: "object",
    properties: { query: { type: "string", description: "Design ID, e.g. MC2045" } },
    required: ["query"],
  },
}];

app.post("/mcp", (req, res) => {
  const { method, id, params } = req.body;
  let result: unknown = {};

  if (method === "initialize") {
    result = {
      protocolVersion: "2025-06-18",
      serverInfo: { name: "acme-commerce", version: "1.0" },
      capabilities: { tools: {} },
    };
  } else if (method === "tools/list") {
    result = { tools: TOOLS };
  } else if (method === "tools/call") {
    // const tenant = tenantFor(req.headers.authorization);
    const query = params?.arguments?.query ?? "";
    result = { content: [{ type: "text", text: `${query}: georgette, 5 colours, Rs 1,450` }] };
  }

  res.json({ jsonrpc: "2.0", id, result });
});