asm-spec/examples/mcp-server-json/operational-envelope-with-asm.server.json at main · calebguo007/asm-spec · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
  "name": "io.asm.example/guarded-web-search",
  "description": "MCP server example with ASM value metadata plus draft v0.4 operational constraints.",
  "status": "active",
  "repository": {
    "url": "https://github.com/calebguo007/asm-spec",
    "source": "github"
  },
  "version": "1.0.0",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://mcp.example.com/search"
    }
  ],
  "_meta": {
    "io.modelcontextprotocol.registry/publisher-provided": {
      "asm": {
        "asm_version": "0.3",
        "service_id": "example/guarded-web-search@1.0",
        "taxonomy": "tool.data.search",
        "display_name": "Example Guarded Web Search MCP",
        "provenance": {
          "source_url": "https://mcp.example.com/.well-known/asm",
          "retrieved_at": "2026-05-25T00:00:00Z",
          "last_verified_at": "2026-05-25T00:00:00Z",
          "verification_status": "self_reported",
          "notes": "Demonstrates the draft v0.4 operational_constraints field as forward-compatible metadata inside an ASM v0.3 manifest."
        },
        "pricing": {
          "billing_dimensions": [
            {
              "dimension": "query",
              "unit": "per_1K",
              "cost_per_unit": 2.5,
              "currency": "USD"
            }
          ],
          "free_tier": {
            "dimension": "query",
            "limit": 1000,
            "period": "monthly"
          }
        },
        "quality": {
          "metrics": [
            {
              "name": "answer_relevance",
              "score": 0.91,
              "scale": "0-1",
              "benchmark": "internal search relevance eval",
              "self_reported": true
            }
          ]
        },
        "sla": {
          "latency_p50": "650ms",
          "latency_p99": "2s",
          "uptime": 0.995,
          "rate_limit": "60 req/min",
          "regions": ["us-east-1", "eu-west-1"]
        },
        "payment": {
          "methods": ["stripe"],
          "auth_type": "oauth2",
          "signup_url": "https://mcp.example.com/signup",
          "receipt_endpoint": "https://mcp.example.com/.well-known/asm-receipts",
          "receipt_envelope_version": "0.1",
          "supports_delegated_receipts": false
        },
        "operational_constraints": {
          "risk_class": "medium",
          "side_effects": ["external_api_call", "network_access"],
          "approval": {
            "required": "conditional",
            "conditions": [
              "estimated_cost_usd > 1.00",
              "query_targets_private_data == true"
            ],
            "human_readable": "Require approval for expensive searches or searches over private data."
          },
          "spend_caps": {
            "per_call_usd": 1.0,
            "per_day_usd": 25.0,
            "currency": "USD"
          },
          "quotas": [
            {
              "dimension": "query",
              "limit": 10000,
              "period": "monthly",
              "scope": "account"
            }
          ],
          "rate_limits": [
            {
              "dimension": "query",
              "limit": 60,
              "period": "minute",
              "scope": "account",
              "burst": 10
            }
          ],
          "receipt_required": true,
          "policy_notes": "Publisher-declared operational envelope. Consumer policy remains authoritative."
        }
      },
      "asm_url": "https://mcp.example.com/.well-known/asm"
    }
  }
}