margins-mcp Server

The oracle as infrastructure. Any AI agent in India can call MARGINS as a tool via JSON-RPC 2.0.

Public Tool Endpoint

Wire into Claude Desktop / External Agent

// claude_desktop_config.json
{
  "mcpServers": {
    "margins": {
      "command": "npx",
      "args": ["-y", "margins-mcp"],
      "env": { "MARGINS_ENDPOINT": "https://margins-mcp.example.com/api/mcp" }
    }
  }
}

Interactive Test HarnessAmul Butter 500g

# Discover the oracle manifest
$ curl https://margins-mcp.example.com/.well-known/mcp.json

# Call it from any external AI agent
$ curl -X POST https://margins-mcp.example.com/api/mcp \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "method": "tools/call",
      "params": {
        "name": "fair_price_band",
        "arguments": { "gtin": "8901058851649", "city": "Madurai" }
      },
      "id": 1
    }'

Callable Tools Registered

fair_price_bandPrimary Oracle

Compute fair-price band for any Indian product given GTIN + city + quantity. Backed by GS1, Agmarknet, ONDC.

place_beckn_orderCommerce Action

Place an order through the ONDC Beckn network at the verified fair price.

query_margins_ledgerFintech Memory

Query a merchant history. "What did I buy last Tuesday?" answered with provenance.