model-optimized

Model-Optimized Weather Service

A variant-aware MCP server that exposes the same tools (get_weather, get_forecast) with different descriptions optimized for different LLM families. This is the primary use case described in SEP-2053.

Pattern demonstrated: Same tools, different descriptions per variant.

Variants

All three variants expose the same two tools with the same behavior — only the tool descriptions differ.

Custom Ranking

Clients send a "modelFamily" hint (e.g., "anthropic", "openai"). The ranking function matches the hint to the variant's modelFamily, falling back to priority order.

Run

go run ./examples/server/model-optimized

The server listens on http://localhost:8080.

Connect any MCP client to http://localhost:8080.

Try It

1. Initialize without hints (default ranking)

curl -s -X POST http://localhost:8080/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "clientInfo": {"name": "test", "version": "1.0"},
      "capabilities": {}
    }
  }'

The first variant in the response is the default — clients that don't specify a variant in subsequent requests will use it. Without hints, claude-optimized is the default:

{
  "availableVariants": [
    {
      "id": "claude-optimized",
      "hints": { "contextSize": "verbose", "modelFamily": "anthropic" },
      "status": "stable"
    },
    {
      "id": "gpt-optimized",
      "hints": { "contextSize": "standard", "modelFamily": "openai" },
      "status": "stable"
    },
    {
      "id": "compact",
      "hints": { "contextSize": "compact", "modelFamily": "any" },
      "status": "stable"
    }
  ]
}

2. Initialize with an OpenAI hint (ranking changes)

curl -s -X POST http://localhost:8080/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0", "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "clientInfo": {"name": "test", "version": "1.0"},
      "capabilities": {
        "experimental": {
          "io.modelcontextprotocol/server-variants": {
            "variantHints": {
              "hints": {"modelFamily": "openai"}
            }
          }
        }
      }
    }
  }'

Now gpt-optimized is ranked first and becomes the default:

{
  "availableVariants": [
    {
      "id": "gpt-optimized",
      "hints": { "contextSize": "standard", "modelFamily": "openai" },
      "status": "stable"
    },
    {
      "id": "claude-optimized",
      "hints": { "contextSize": "verbose", "modelFamily": "anthropic" },
      "status": "stable"
    },
    {
      "id": "compact",
      "hints": { "contextSize": "compact", "modelFamily": "any" },
      "status": "stable"
    }
  ]
}