@agentmanifest/mcp-server 0.0.0-stage → 0.1.2

package/schemas/v0.2/manifest.json

@@ -0,0 +1,290 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://agent-manifest.com/schemas/v0.2/manifest.json",
+  "title": "Agent Manifest v0.2",
+  "description": "Schema for manifests that declare spec_version agentmanifest-0.2. It accepts everything the AMP validator accepted for v0.2 manifests before revision 0.3.1, plus the v0.2 payment block and the 'freemium' pricing model.",
+  "type": "object",
+  "required": [
+    "spec_version",
+    "name",
+    "version",
+    "description",
+    "categories",
+    "primary_category",
+    "endpoints",
+    "pricing",
+    "authentication",
+    "agent_notes",
+    "contact",
+    "last_updated"
+  ],
+  "properties": {
+    "spec_version": {
+      "type": "string",
+      "enum": ["agentmanifest-0.2"],
+      "description": "Version of the AgentManifest specification"
+    },
+    "name": {
+      "type": "string",
+      "minLength": 3,
+      "maxLength": 100,
+      "description": "Human-readable name of the API"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\\+([0-9a-zA-Z-]+(?:\\.[0-9a-zA-Z-]+)*))?$",
+      "description": "Semantic version of the API"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 100,
+      "description": "Plain language explanation for AI agents"
+    },
+    "homepage": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to the API homepage"
+    },
+    "documentation": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL to external documentation"
+    },
+    "categories": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "enum": [
+          "food-science",
+          "materials",
+          "construction",
+          "music-gear",
+          "chemistry",
+          "biology",
+          "physics",
+          "mathematics",
+          "geography",
+          "finance",
+          "legal",
+          "medical",
+          "engineering",
+          "education",
+          "translation",
+          "media",
+          "agriculture",
+          "computing",
+          "language",
+          "history",
+          "commerce",
+          "identity",
+          "weather",
+          "logistics",
+          "other"
+        ]
+      },
+      "description": "Categories from controlled vocabulary"
+    },
+    "primary_category": {
+      "type": "string",
+      "enum": [
+        "reference",
+        "live",
+        "computational",
+        "transactional",
+        "enrichment",
+        "personal",
+        "discovery"
+      ],
+      "description": "Primary classification of the API"
+    },
+    "endpoints": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["path", "method", "description", "parameters", "response_description"],
+        "properties": {
+          "path": {
+            "type": "string",
+            "pattern": "^/",
+            "description": "API endpoint path"
+          },
+          "method": {
+            "type": "string",
+            "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"],
+            "description": "HTTP method"
+          },
+          "description": {
+            "type": "string",
+            "minLength": 20,
+            "description": "When and why agents should use this endpoint"
+          },
+          "parameters": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["name", "type", "required", "description"],
+              "properties": {
+                "name": { "type": "string" },
+                "type": { "type": "string" },
+                "required": { "type": "boolean" },
+                "description": { "type": "string" }
+              }
+            },
+            "description": "Array of parameter objects"
+          },
+          "response_description": {
+            "type": "string",
+            "minLength": 20,
+            "description": "Response content and interpretation guide"
+          }
+        }
+      },
+      "description": "Available API endpoints"
+    },
+    "pricing": {
+      "type": "object",
+      "required": ["model"],
+      "properties": {
+        "model": {
+          "type": "string",
+          "enum": [
+            "free",
+            "freemium",
+            "per-query",
+            "subscription",
+            "pay-what-you-want",
+            "tiered",
+            "usage_based"
+          ],
+          "description": "Pricing model. 'freemium' was added alongside specification revision 0.3.1."
+        },
+        "free_tier": {
+          "type": ["object", "null"],
+          "properties": {
+            "queries_per_day": { "type": ["number", "null"], "minimum": 0 },
+            "queries_per_month": { "type": ["number", "null"], "minimum": 0 }
+          },
+          "description": "Free usage limits"
+        },
+        "paid_tier": {
+          "type": ["object", "null"],
+          "required": ["amount_usd", "unit", "description"],
+          "properties": {
+            "amount_usd": { "type": "number", "minimum": 0 },
+            "unit": { "type": "string" },
+            "description": { "type": "string" }
+          },
+          "description": "Paid tier details"
+        },
+        "support_url": {
+          "type": ["string", "null"],
+          "format": "uri",
+          "description": "URL for voluntary contributions or payment"
+        }
+      },
+      "description": "Pricing information"
+    },
+    "payment": {
+      "anyOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "required": ["checkout_url"],
+          "properties": {
+            "provider": {
+              "type": "string",
+              "description": "Payment provider name"
+            },
+            "checkout_url": {
+              "type": "string",
+              "format": "uri",
+              "description": "URL where agents can complete payment or purchase API access"
+            },
+            "key_provisioning_url": {
+              "type": "string",
+              "format": "uri",
+              "description": "URL where agents can retrieve API keys after payment"
+            },
+            "accepted_methods": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Payment methods accepted (e.g., credit_card, crypto, paypal)"
+            },
+            "prepay_required": {
+              "type": "boolean",
+              "description": "Whether payment is required before API access"
+            }
+          }
+        }
+      ],
+      "description": "Optional payment configuration for API access"
+    },
+    "authentication": {
+      "type": "object",
+      "required": ["required"],
+      "properties": {
+        "required": { "type": "boolean" },
+        "type": {
+          "type": ["string", "null"],
+          "enum": ["api_key", "oauth2", "bearer", "none", null]
+        },
+        "instructions": { "type": ["string", "null"] },
+        "config": { "type": "object" }
+      },
+      "description": "Authentication requirements"
+    },
+    "reliability": {
+      "type": "object",
+      "properties": {
+        "maintained_by": {
+          "type": "string",
+          "enum": ["individual", "organization", "community"]
+        },
+        "status_url": { "type": ["string", "null"], "format": "uri" },
+        "expected_uptime_pct": { "type": ["number", "null"], "minimum": 0, "maximum": 100 },
+        "uptime_percentage": { "type": "number", "minimum": 0, "maximum": 100 },
+        "avg_response_time_ms": { "type": "integer", "minimum": 0 },
+        "last_30_days_uptime": { "type": "number", "minimum": 0, "maximum": 100 }
+      },
+      "description": "Reliability information"
+    },
+    "rate_limits": {
+      "type": "object",
+      "properties": {
+        "requests_per_minute": { "type": ["integer", "null"], "minimum": 0 },
+        "requests_per_day": { "type": ["integer", "null"], "minimum": 0 }
+      }
+    },
+    "agent_notes": {
+      "type": "string",
+      "minLength": 50,
+      "description": "Freeform guidance for AI agents"
+    },
+    "contact": {
+      "description": "Contact email, URL, or object",
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "email": { "type": "string", "format": "email" },
+            "support_url": { "type": "string", "format": "uri" },
+            "github": { "type": "string", "format": "uri" }
+          }
+        }
+      ]
+    },
+    "listing_requested": {
+      "type": "boolean",
+      "description": "Whether API requests public listing"
+    },
+    "last_updated": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last manifest update"
+    }
+  },
+  "additionalProperties": true
+}