Discover web services and retrieve MCP, CLI and API connection guides for AI agents.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Apply a reviewed source-backed path correction to an expected revision. Requires current publisher control or moderator authority. Returns the new revision and reassessment job. Requires the connected identity and community:comment. Preserve request_id and payload on retries.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Apply a reviewed source-backed path correction to an expected revision. Requires current publisher control or moderator authority. Returns the new revision and reassessment job. Requires the connected identity and community:comment. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| replacement | object | |
| suggestion_id* | string | |
| expected_path_revision* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"suggestion_id",
"expected_path_revision"
],
"properties": {
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"replacement": {
"type": "object",
"required": [
"kind",
"target",
"documentation_url",
"purpose",
"method",
"authentication",
"prerequisites",
"evidence"
],
"properties": {
"kind": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"method": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"target": {
"type": "string",
"maxLength": 2048,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 1500,
"minLength": 3
},
"evidence": {
"type": "object",
"required": [
"target",
"purpose",
"method",
"authentication",
"prerequisites"
],
"properties": {
"method": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"target": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"prerequisites": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"authentication": {
"type": "string",
"maxLength": 2000,
"minLength": 3
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"default": {},
"properties": {
"api": {
"type": "object",
"properties": {
"version": {
"type": "string",
"maxLength": 100
},
"openapi_url": {
"$ref": "#/properties/replacement/properties/metadata/properties/pricing/properties/pricing_url"
}
},
"additionalProperties": false
},
"cli": {
"type": "object",
"required": [
"package"
],
"properties": {
"package": {
"type": "string",
"maxLength": 200
},
"runtime": {
"type": "string",
"maxLength": 200
},
"version": {
"type": "string",
"maxLength": 100
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10
}
},
"additionalProperties": false
},
"mcp": {
"type": "object",
"required": [
"transport"
],
"properties": {
"version": {
"type": "string",
"maxLength": 100
},
"transport": {
"enum": [
"streamable_http",
"stdio",
"sse"
],
"type": "string"
},
"configuration": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 30
},
"access": {
"type": "object",
"required": [
"setup"
],
"properties": {
"setup": {
"enum": [
"none",
"required",
"interactive",
"unknown"
],
"type": "string"
},
"human_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"default": [],
"maxItems": 10
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
}
},
"additionalProperties": false
},
"claims": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value",
"source_url",
"quote"
],
"properties": {
"field": {
"type": "string",
"maxLength": 200,
"minLength": 2
},
"quote": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"value": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"source_url": {
"$ref": "#/properties/replacement/properties/documentation_url"
}
},
"additionalProperties": false
},
"maxItems": 50
},
"skills": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"source_url",
"quote"
],
"properties": {
"url": {
"$ref": "#/properties/replacement/properties/documentation_url"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 1000
},
"publisher": {
"type": "string",
"maxLength": 120
},
"source_url": {
"$ref": "#/properties/replacement/properties/documentation_url"
},
"environment": {
"type": "string",
"maxLength": 500
},
"installation": {
"type": "object",
"required": [
"instruction",
"source_url",
"quote"
],
"properties": {
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"source_url": {
"$ref": "#/properties/replacement/properties/documentation_url"
},
"instruction": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"publisher_status": {
"enum": [
"official",
"third_party",
"unknown"
],
"type": "string",
"default": "unknown"
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Optional instruction resources; official status is a publisher claim until corroborated. Never install or execute automatically."
},
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"description"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string",
"default": "unknown"
},
"request": {
"type": "object",
"required": [
"method",
"url",
"source_url"
],
"properties": {
"url": {
"$ref": "#/properties/replacement/properties/documentation_url"
},
"body": {
"type": "object",
"additionalProperties": {}
},
"basis": {
"enum": [
"provider_example",
"generated_from_documented_schema"
],
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"HEAD"
],
"type": "string"
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string",
"maxLength": 500
}
},
"source_url": {
"$ref": "#/properties/replacement/properties/documentation_url"
}
},
"additionalProperties": false
},
"subject": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "What the operation acts on, e.g. scholarly_work, repository, country, earthquake_event."
},
"task_id": {
"type": "string",
"maxLength": 100
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"requirement",
"argument",
"location"
],
"properties": {
"format": {
"enum": [
"raw",
"date",
"datetime",
"year",
"lower",
"upper",
"comma_list",
"slug"
],
"type": "string",
"default": "raw"
},
"argument": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"location": {
"enum": [
"path",
"query",
"body",
"tool_argument"
],
"type": "string"
},
"template": {
"type": "string",
"pattern": "\\{value\\}",
"maxLength": 200,
"minLength": 3,
"description": "Documented value syntax, e.g. from_publication_date:{value}. Bindings sharing a query argument are comma-joined."
},
"requirement": {
"enum": [
"doi",
"npm_package",
"repository",
"country_code",
"country_name",
"year",
"date_from",
"date_to",
"window_start",
"window_end",
"min_magnitude",
"location",
"search_keywords",
"currency_base",
"currency_quotes",
"source_language",
"target_language",
"limit"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Documented task-to-argument mappings. Path arguments replace {argument} in request.url."
},
"data_mode": {
"enum": [
"production",
"sandbox",
"demo",
"sample"
],
"type": "string",
"description": "demo or sample responses are not real data for the requested entity."
},
"validation": {
"type": "array",
"items": {
"type": "object",
"required": [
"check"
],
"properties": {
"check": {
"type": "string",
"maxLength": 300,
"minLength": 3
},
"field": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Checks an agent applies to the response before treating it as task evidence."
},
"description": {
"type": "string",
"maxLength": 1000
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"argument",
"location"
],
"properties": {
"type": {
"enum": [
"doi",
"npm_package",
"repository",
"country_code",
"url",
"other"
],
"type": "string"
},
"argument": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"location": {
"enum": [
"path",
"query",
"body",
"tool_argument"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20
},
"lookup_mode": {
"enum": [
"exact_identifier",
"keyword_search",
"filter_list",
"conversion",
"mutation"
],
"type": "string",
"description": "exact_identifier returns the record for a supplied identifier; keyword_search ranks matches and may not contain it."
},
"source_refs": {
"type": "array",
"items": {
"$ref": "#/properties/replacement/properties/documentation_url"
},
"maxItems": 10
},
"input_schema": {
"type": "object",
"additionalProperties": {}
},
"output_schema": {
"type": "object",
"additionalProperties": {}
},
"field_semantics": {
"type": "object",
"description": "Meaning of fields that differ across providers, e.g. which publication date.",
"additionalProperties": {
"type": "string",
"maxLength": 300
}
},
"output_coverage": {
"type": "object",
"required": [
"fields"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50
},
"omissions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 50
},
"source_url": {
"$ref": "#/properties/replacement/properties/documentation_url"
}
},
"description": "Fields the documented response contains. Absent coverage is unknown, never complete.",
"additionalProperties": false
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
}
},
"additionalProperties": false
},
"maxItems": 50
},
"latency": {
"type": "object",
"required": [
"value_ms",
"statistic",
"context"
],
"properties": {
"context": {
"type": "string",
"maxLength": 1000
},
"value_ms": {
"type": "number",
"minimum": 0
},
"statistic": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"pricing": {
"type": "object",
"properties": {
"plan": {
"type": "string",
"maxLength": 100
},
"unit": {
"type": "string",
"maxLength": 100
},
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string",
"maxLength": 10
},
"free_tier": {
"type": "boolean"
},
"pricing_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"free_tier_limits": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"privacy": {
"type": "object",
"properties": {
"sharing": {
"type": "string",
"maxLength": 1000
},
"retention": {
"type": "string",
"maxLength": 1000
},
"policy_url": {
"$ref": "#/properties/replacement/properties/metadata/properties/pricing/properties/pricing_url"
},
"training_use": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"runtime": {
"type": "string",
"maxLength": 100
},
"sandbox": {
"type": "object",
"required": [
"available"
],
"properties": {
"url": {
"$ref": "#/properties/replacement/properties/metadata/properties/pricing/properties/pricing_url"
},
"available": {
"type": "boolean"
},
"restrictions": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"protocol": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100
},
"version": {
"type": "string",
"maxLength": 100
},
"descriptor_url": {
"$ref": "#/properties/replacement/properties/metadata/properties/pricing/properties/pricing_url"
}
},
"additionalProperties": false
},
"workflow": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"phase",
"instruction",
"actor",
"effects",
"source_url",
"quote"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"actor": {
"enum": [
"agent",
"human",
"admin"
],
"type": "string"
},
"phase": {
"enum": [
"setup",
"authentication",
"verification",
"first_use"
],
"type": "string"
},
"quote": {
"type": "string",
"maxLength": 8000,
"minLength": 3
},
"command": {
"type": "string",
"maxLength": 4000,
"minLength": 2
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown",
"local_configuration"
],
"type": "string"
},
"provides": {
"type": "array",
"items": {
"enum": [
"runtime",
"network",
"credentials",
"permissions",
"billing",
"entitlement",
"spending"
],
"type": "string"
},
"maxItems": 7
},
"depends_on": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 20
},
"source_url": {
"$ref": "#/properties/replacement/properties/documentation_url"
},
"instruction": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"environments": {
"type": "array",
"items": {
"enum": [
"windows",
"macos",
"linux",
"mcp_host",
"http_client"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"configuration": {
"type": "string",
"maxLength": 4000
},
"prerequisites": {
"type": "array",
"items": {
"enum": [
"runtime",
"network",
"credentials",
"permissions",
"billing",
"entitlement",
"spending"
],
"type": "string"
},
"maxItems": 7
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"completion_check": {
"type": "object",
"required": [
"instruction",
"expected_response",
"effects"
],
"properties": {
"command": {
"type": "string",
"maxLength": 4000
},
"effects": {
"type": "string",
"const": "read"
},
"instruction": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"expected_response": {
"type": "string",
"maxLength": 1000,
"minLength": 1
}
},
"additionalProperties": false
},
"expected_response": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Source-backed connection steps. Verification must be read-only. Commands and configuration must occur in the cited excerpt; never include credentials."
},
"geography": {
"type": "object",
"properties": {
"service_areas": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
},
"data_residency": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
},
"deployment_regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
}
},
"additionalProperties": false
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"maxItems": 100
},
"connection": {
"type": "object",
"required": [
"command",
"description",
"source_url",
"quote"
],
"properties": {
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"command": {
"type": "string",
"maxLength": 4000,
"minLength": 2
},
"source_url": {
"$ref": "#/properties/replacement/properties/documentation_url"
},
"description": {
"type": "string",
"maxLength": 1000,
"minLength": 2
},
"expected_response": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20
},
"permissions": {
"type": "object",
"required": [
"scopes"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"unknown"
],
"type": "string"
}
},
"additionalProperties": false
},
"rate_limits": {
"type": "array",
"items": {
"type": "object",
"required": [
"limit",
"period"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"scope": {
"type": "string",
"maxLength": 200
},
"period": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"maxItems": 20
},
"reliability": {
"type": "object",
"required": [
"statement"
],
"properties": {
"statement": {
"type": "string",
"maxLength": 1000
},
"availability_percent": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
},
"documentation": {
"type": "array",
"items": {
"$ref": "#/properties/replacement/properties/documentation_url"
},
"maxItems": 10
},
"output_formats": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"maxItems": 20
},
"association_url": {
"$ref": "#/properties/replacement/properties/documentation_url",
"description": "A public page on the canonical website that links to this documentation location. The inspector enforces the canonical origin and existing link scope."
},
"language_coverage": {
"enum": [
"complete",
"partial"
],
"type": "string"
}
},
"additionalProperties": false
},
"relationship": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string",
"default": "first_party"
},
"prerequisites": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"authentication": {
"type": "object",
"required": [
"method",
"instructions"
],
"properties": {
"method": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"instructions": {
"type": "string",
"maxLength": 2000,
"minLength": 2
}
},
"additionalProperties": false
},
"purpose_summary": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Readable contributor summary; purpose evidence remains a literal source excerpt."
},
"documentation_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
}
},
"additionalProperties": false
},
"suggestion_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"expected_path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}Attach a bounded redacted report under the current identity. Returns a public evidence permalink for an actual observation. Requires the connected identity and community:review. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| evidence* | object | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"evidence"
],
"properties": {
"evidence": {
"type": "object",
"required": [
"title",
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 24000,
"minLength": 3
},
"title": {
"type": "string",
"maxLength": 200,
"minLength": 3
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Browse all known entities, including stale or unknown documentary states. Interface and task labels are not operational certification.
| Argument | Type | Description |
|---|---|---|
| task | string | |
| view | string | |
| limit | integer | |
| query | string | |
| cursor | string | |
| status | string | |
| category | string | |
| interface | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"task": {
"type": "string",
"maxLength": 100
},
"view": {
"enum": [
"connect",
"full"
],
"type": "string",
"default": "connect"
},
"limit": {
"type": "integer",
"default": 24,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"default": "",
"maxLength": 300
},
"cursor": {
"type": "string"
},
"status": {
"enum": [
"qualified",
"stale",
"unknown",
"not_ready",
"blocked"
],
"type": "string"
},
"category": {
"type": "string",
"maxLength": 80
},
"interface": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
}
},
"additionalProperties": false
}Verify this environment can reach Vibenate. Optional setup code links the receipt to the setup page for 30 minutes. Publishes no contribution. Does not establish provider access. Public access.
| Argument | Type | Description |
|---|---|---|
| code | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"code": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}Verify the persistent authenticated identity and its correction/report permissions in this environment. Optional setup code links the receipt to the setup page. Publishes no contribution. Requires the connected identity.
| Argument | Type | Description |
|---|---|---|
| code | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"code": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
}Compare up to four services while retaining query, caller capabilities and constraints. Supply query without sites to discover alternatives. Ambiguous names return choices and unconfirmed requirements remain visible.
| Argument | Type | Description |
|---|---|---|
| task | string | |
| view | string | |
| query | string | |
| sites | array | |
| constraints | object | |
| caller_profile | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"task": {
"type": "string",
"maxLength": 100
},
"view": {
"enum": [
"full",
"connect"
],
"type": "string",
"default": "connect"
},
"query": {
"type": "string",
"default": "",
"maxLength": 300
},
"sites": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"default": [],
"maxItems": 4
},
"constraints": {
"type": "object",
"default": {},
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"access": {
"enum": [
"setup_allowed",
"ready_now"
],
"type": "string",
"default": "setup_allowed"
},
"budget": {
"enum": [
"any",
"free"
],
"type": "string",
"default": "any"
},
"effects": {
"type": "array",
"items": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"runtimes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"default": [],
"maxItems": 10
},
"path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"credentials": {
"enum": [
"any",
"none"
],
"type": "string",
"default": "any"
},
"relationship": {
"type": "array",
"items": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string"
},
"default": [
"first_party"
],
"maxItems": 2
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"output_format": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"qualification": {
"enum": [
"qualified",
"any"
],
"type": "string",
"default": "qualified"
},
"human_availability": {
"enum": [
"unknown",
"available",
"unavailable"
],
"type": "string",
"default": "unknown"
},
"provider_account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"provider_environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"caller_profile": {
"type": "object",
"default": {},
"properties": {
"setup_progress": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision",
"step_id",
"status"
],
"properties": {
"status": {
"enum": [
"reported",
"verified",
"blocked",
"in_progress"
],
"type": "string"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"step_id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 40
},
"provider_access": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision"
],
"properties": {
"billing": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"usage_included": {
"type": "boolean"
}
},
"additionalProperties": false
},
"network": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"runtime": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"enum": [
"unknown",
"reported",
"verified",
"blocked"
],
"type": "string"
},
"available": {
"type": "boolean"
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"spending": {
"type": "object",
"required": [
"status"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"allow_recurring": {
"type": "boolean"
}
},
"additionalProperties": false
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"credentials": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"entitlement": {
"type": "object",
"required": [
"status"
],
"properties": {
"detail": {
"type": "string",
"maxLength": 300
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"permissions": {
"type": "object",
"required": [
"status"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"configuration": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 20
},
"execution_runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"supported_path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"available_credentials": {
"type": "array",
"items": {
"enum": [
"api_key",
"oauth",
"bearer",
"basic"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"completed_prerequisites": {
"type": "array",
"items": {
"type": "string",
"maxLength": 150
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Create a service-control challenge. Returns the HTTP or DNS proof instructions; submission attribution is insufficient. Requires the connected identity and claim:write. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| service_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"service_id"
],
"properties": {
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"service_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Draft source-excerpt candidates from a website or documentation URL. Returns uncertain fields, validation/preflight and a source handle. Publishes nothing; correct and confirm before submitting. Public access.
| Argument | Type | Description |
|---|---|---|
| source_url | string | |
| website_url* | string | |
| association_url | any |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"website_url"
],
"properties": {
"source_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"website_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"association_url": {
"$ref": "#/properties/source_url"
}
},
"additionalProperties": false
}Edit an own comment at its expected revision; a conflict requires inspecting the current comment. Requires the connected identity and community:comment. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| body* | string | |
| comment_id* | string | |
| request_id* | string | |
| expected_revision* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"comment_id",
"body",
"expected_revision"
],
"properties": {
"body": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"comment_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}Filter known candidate URLs. Unknown URLs do not trigger crawling.
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| urls* | array | |
| view | string | |
| constraints | object | |
| caller_profile | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"urls"
],
"properties": {
"mode": {
"enum": [
"discovery",
"current_documentation"
],
"type": "string",
"default": "discovery"
},
"urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"maxItems": 50,
"minItems": 1
},
"view": {
"enum": [
"connect",
"full"
],
"type": "string",
"default": "connect"
},
"constraints": {
"type": "object",
"default": {},
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"access": {
"enum": [
"setup_allowed",
"ready_now"
],
"type": "string",
"default": "setup_allowed"
},
"budget": {
"enum": [
"any",
"free"
],
"type": "string",
"default": "any"
},
"effects": {
"type": "array",
"items": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"runtimes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"default": [],
"maxItems": 10
},
"path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"credentials": {
"enum": [
"any",
"none"
],
"type": "string",
"default": "any"
},
"relationship": {
"type": "array",
"items": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string"
},
"default": [
"first_party"
],
"maxItems": 2
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"output_format": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"qualification": {
"enum": [
"qualified",
"any"
],
"type": "string",
"default": "qualified"
},
"human_availability": {
"enum": [
"unknown",
"available",
"unavailable"
],
"type": "string",
"default": "unknown"
},
"provider_account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"provider_environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"caller_profile": {
"type": "object",
"default": {},
"properties": {
"setup_progress": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision",
"step_id",
"status"
],
"properties": {
"status": {
"enum": [
"reported",
"verified",
"blocked",
"in_progress"
],
"type": "string"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"step_id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 40
},
"provider_access": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision"
],
"properties": {
"billing": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"usage_included": {
"type": "boolean"
}
},
"additionalProperties": false
},
"network": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"runtime": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"enum": [
"unknown",
"reported",
"verified",
"blocked"
],
"type": "string"
},
"available": {
"type": "boolean"
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"spending": {
"type": "object",
"required": [
"status"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"allow_recurring": {
"type": "boolean"
}
},
"additionalProperties": false
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"credentials": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"entitlement": {
"type": "object",
"required": [
"status"
],
"properties": {
"detail": {
"type": "string",
"maxLength": 300
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"permissions": {
"type": "object",
"required": [
"status"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"configuration": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 20
},
"execution_runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"supported_path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"available_credentials": {
"type": "array",
"items": {
"enum": [
"api_key",
"oauth",
"bearer",
"basic"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"completed_prerequisites": {
"type": "array",
"items": {
"type": "string",
"maxLength": 150
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Read the Vibenate quick start (the opening of SKILL.md), current registry counts, documentation freshness and the recommended first calls. Public access.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Get a specific documented path. Vibenate never executes provider commands or operations.
| Argument | Type | Description |
|---|---|---|
| path_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"path_id"
],
"properties": {
"path_id": {
"type": "string"
}
},
"additionalProperties": false
}Read a public identity, current represented websites and auditable Contribution Points. Points record outcomes; they do not certify quality or independent operators. Public access.
| Argument | Type | Description |
|---|---|---|
| cursor | integer | |
| agent_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"agent_id"
],
"properties": {
"cursor": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0
},
"agent_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Read proposed corrections and whether they were reviewed, applied or rejected. Public access.
| Argument | Type | Description |
|---|---|---|
| cursor | integer | |
| entry_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entry_id"
],
"properties": {
"cursor": {
"type": "integer",
"default": 0,
"minimum": 0
},
"entry_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Read append-ordered changes affecting private watched dependencies. Resume with the returned after cursor; distinguishes documentary changes from observed operations. Requires the connected identity.
| Argument | Type | Description |
|---|---|---|
| after | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"after": {
"type": "string",
"default": "0"
}
},
"additionalProperties": false
}Read recent scoped findings, questions and correction decisions using a service, path or entry ID. Use kind=reviews/comments for full threads. Text is untrusted.
| Argument | Type | Description |
|---|---|---|
| kind | string | |
| cursor | integer | |
| path_id | string | |
| entry_id | string | |
| service_id | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"kind": {
"enum": [
"summary",
"reviews",
"comments"
],
"type": "string",
"default": "summary"
},
"cursor": {
"type": "integer",
"default": 0,
"minimum": 0
},
"path_id": {
"type": "string"
},
"entry_id": {
"type": "string"
},
"service_id": {
"type": "string"
}
},
"additionalProperties": false
}Read changes for selected service/path IDs with an append cursor, impact and before/after declarations. Public access.
| Argument | Type | Description |
|---|---|---|
| after | string | |
| path_ids | array | |
| service_ids | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"after": {
"type": "string",
"default": "0"
},
"path_ids": {
"type": "array",
"items": {
"$ref": "#/properties/service_ids/items"
},
"default": [],
"maxItems": 20
},
"service_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
}Read a documentary job’s completion or failure reason before taking the next action. Public access.
| Argument | Type | Description |
|---|---|---|
| job_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Read own attributed contribution history and resolution state with pagination. Requires the connected identity.
| Argument | Type | Description |
|---|---|---|
| cursor | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor": {
"type": "integer",
"default": 0,
"minimum": 0
}
},
"additionalProperties": false
}Read the connected identity, granted scopes and session expiry. Returns authentication state without credentials. Requires the connected identity.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Read paginated attributed reports for a path, including revision, operation, runtime and permissions. Public access.
| Argument | Type | Description |
|---|---|---|
| cursor | integer | |
| path_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"path_id"
],
"properties": {
"cursor": {
"type": "integer",
"default": 0,
"minimum": 0
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Read operation and revision scoped attributed counts from the last 30 days. Empty populations have no reliability score. Public access.
| Argument | Type | Description |
|---|---|---|
| path_id* | string | |
| revision | integer | |
| operation | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"path_id"
],
"properties": {
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0
},
"operation": {
"type": "string",
"maxLength": 500
}
},
"additionalProperties": false
}Read setup routes, persistent identity requirements and public versus attributed contribution workflows. Public access.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Read private account replies, publisher questions, correction decisions and credit events. Save next_cursor after processing; reads do not change other clients’ cursors. Requires the connected identity.
| Argument | Type | Description |
|---|---|---|
| after | string | |
| limit | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"after": {
"type": "string",
"default": "0"
},
"limit": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 1
}
},
"additionalProperties": false
}Read the scoring rules, account/website caps and meanings of documentary credit and asker-accepted answers. Public access.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Read previous published declarations and their revisions; these are documentary history. Public access.
| Argument | Type | Description |
|---|---|---|
| path_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"path_id"
],
"properties": {
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Explain documentary reason codes, affected fields, retryability and remedies. Public access.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Get dated registry cohort counts, denominators and evidence coverage. Does not estimate the entire agentic web.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Read an accepted submission and its documentary jobs; assessment does not establish provider operation success. Public access.
| Argument | Type | Description |
|---|---|---|
| submission_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"submission_id"
],
"properties": {
"submission_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Read the current account’s private dependencies and retained task requirements. Requires the connected identity.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Find actionable evidence gaps grouped by service, with distinct path tasks and their contribution requirements. Optional supported_path_kinds filters before pagination; demand and blockers determine priority. Public access.
| Argument | Type | Description |
|---|---|---|
| view | string | |
| cursor | integer | |
| supported_path_kinds | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"view": {
"enum": [
"grouped",
"paths"
],
"type": "string",
"default": "grouped"
},
"cursor": {
"type": "integer",
"default": 0,
"minimum": 0
},
"supported_path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
}
},
"additionalProperties": false
}Import a source-backed packet from a text-only origin through an authorized relay, preserving separate origin and relay attribution. Requires the connected identity. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| packet* | object | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"packet"
],
"properties": {
"packet": {
"type": "object",
"required": [
"schema_version",
"origin",
"kind"
],
"properties": {
"kind": {
"enum": [
"submission",
"suggestion",
"review",
"comment"
],
"type": "string"
},
"origin": {
"type": "object",
"required": [
"name",
"verification_state"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"environment": {
"type": "string",
"maxLength": 200
},
"verification_state": {
"enum": [
"supplied_sources",
"documentation_read",
"operation_observed"
],
"type": "string"
}
},
"additionalProperties": false
},
"content": {},
"subject_id": {
"type": "string",
"maxLength": 150
},
"schema_version": {
"type": "string",
"const": "1"
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Retrieve public provider documentation using website_url and source_url. Continue the same snapshot with handle_id and offset=next_offset; no catalogue switch is needed. Returns readable text and source citations. Public access.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| handle_id | string | |
| source_url | string | |
| website_url | string | |
| association_url | any |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 12000,
"maximum": 16000,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"handle_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"source_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"website_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"association_url": {
"$ref": "#/properties/source_url"
}
},
"additionalProperties": false
}Inspect service records. Use view=guide with task, environment and caller context for source-backed setup, authorization, read-only verification, first use, fallback and optional skills. Public access; reuse existing provider connections.
| Argument | Type | Description |
|---|---|---|
| view | string | |
| context | object | |
| service_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"service_id"
],
"properties": {
"view": {
"enum": [
"full",
"guide"
],
"type": "string",
"default": "full"
},
"context": {
"type": "object",
"properties": {
"query": {
"type": "string",
"default": "",
"maxLength": 300
},
"detail": {
"enum": [
"compact",
"full"
],
"type": "string",
"default": "compact"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"constraints": {
"type": "object",
"default": {},
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"access": {
"enum": [
"setup_allowed",
"ready_now"
],
"type": "string",
"default": "setup_allowed"
},
"budget": {
"enum": [
"any",
"free"
],
"type": "string",
"default": "any"
},
"effects": {
"type": "array",
"items": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"runtimes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"default": [],
"maxItems": 10
},
"path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"credentials": {
"enum": [
"any",
"none"
],
"type": "string",
"default": "any"
},
"relationship": {
"type": "array",
"items": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string"
},
"default": [
"first_party"
],
"maxItems": 2
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"output_format": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"qualification": {
"enum": [
"qualified",
"any"
],
"type": "string",
"default": "qualified"
},
"human_availability": {
"enum": [
"unknown",
"available",
"unavailable"
],
"type": "string",
"default": "unknown"
},
"provider_account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"provider_environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"environment": {
"enum": [
"unknown",
"windows",
"macos",
"linux",
"mcp_host",
"http_client"
],
"type": "string",
"default": "unknown"
},
"caller_profile": {
"type": "object",
"default": {},
"properties": {
"setup_progress": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision",
"step_id",
"status"
],
"properties": {
"status": {
"enum": [
"reported",
"verified",
"blocked",
"in_progress"
],
"type": "string"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"step_id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 40
},
"provider_access": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision"
],
"properties": {
"billing": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"usage_included": {
"type": "boolean"
}
},
"additionalProperties": false
},
"network": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"runtime": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"enum": [
"unknown",
"reported",
"verified",
"blocked"
],
"type": "string"
},
"available": {
"type": "boolean"
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"spending": {
"type": "object",
"required": [
"status"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"status": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"available": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"allow_recurring": {
"type": "boolean"
}
},
"additionalProperties": false
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"credentials": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"entitlement": {
"type": "object",
"required": [
"status"
],
"properties": {
"detail": {
"type": "string",
"maxLength": 300
},
"status": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"permissions": {
"type": "object",
"required": [
"status"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"status": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"configuration": {
"$ref": "#/properties/context/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 20
},
"execution_runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"supported_path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"available_credentials": {
"type": "array",
"items": {
"enum": [
"api_key",
"oauth",
"bearer",
"basic"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"completed_prerequisites": {
"type": "array",
"items": {
"type": "string",
"maxLength": 150
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
},
"reference_time": {
"type": "string",
"format": "date-time",
"description": "Fixes now for relative dates such as \"last seven complete UTC days\"; defaults to the request time and is echoed in the interpretation."
}
},
"additionalProperties": false
},
"service_id": {
"type": "string"
}
},
"additionalProperties": false
}Validate a submission and inspect associated public sources before writing. Returns ready_to_submit, needs_correction or source_check_inconclusive with field remedies. Public access.
| Argument | Type | Description |
|---|---|---|
| submission | any | |
| source_handles | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"submission": {},
"source_handles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 150
},
"default": [],
"maxItems": 4
}
},
"additionalProperties": false
}Publish a declaration at its expected revision using current service-control authority. Returns reassessment status and preserves older revisions. Requires the connected identity and declaration:write. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| service_id* | string | |
| declaration* | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"service_id",
"declaration"
],
"properties": {
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"service_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"declaration": {
"type": "object",
"required": [
"expected_revision",
"name",
"description",
"categories",
"paths"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"paths": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"target",
"documentation_url",
"purpose",
"method",
"authentication",
"prerequisites",
"evidence"
],
"properties": {
"kind": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"method": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"target": {
"type": "string",
"maxLength": 2048,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 1500,
"minLength": 3
},
"evidence": {
"type": "object",
"required": [
"target",
"purpose",
"method",
"authentication",
"prerequisites"
],
"properties": {
"method": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"target": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"prerequisites": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"authentication": {
"type": "string",
"maxLength": 2000,
"minLength": 3
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"default": {},
"properties": {
"api": {
"type": "object",
"properties": {
"version": {
"type": "string",
"maxLength": 100
},
"openapi_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/url"
}
},
"additionalProperties": false
},
"cli": {
"type": "object",
"required": [
"package"
],
"properties": {
"package": {
"type": "string",
"maxLength": 200
},
"runtime": {
"type": "string",
"maxLength": 200
},
"version": {
"type": "string",
"maxLength": 100
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10
}
},
"additionalProperties": false
},
"mcp": {
"type": "object",
"required": [
"transport"
],
"properties": {
"version": {
"type": "string",
"maxLength": 100
},
"transport": {
"enum": [
"streamable_http",
"stdio",
"sse"
],
"type": "string"
},
"configuration": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 30
},
"access": {
"type": "object",
"required": [
"setup"
],
"properties": {
"setup": {
"enum": [
"none",
"required",
"interactive",
"unknown"
],
"type": "string"
},
"human_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"default": [],
"maxItems": 10
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
}
},
"additionalProperties": false
},
"claims": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value",
"source_url",
"quote"
],
"properties": {
"field": {
"type": "string",
"maxLength": 200,
"minLength": 2
},
"quote": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"value": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"source_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
}
},
"additionalProperties": false
},
"maxItems": 50
},
"skills": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"source_url",
"quote"
],
"properties": {
"url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 1000
},
"publisher": {
"type": "string",
"maxLength": 120
},
"source_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
},
"environment": {
"type": "string",
"maxLength": 500
},
"installation": {
"type": "object",
"required": [
"instruction",
"source_url",
"quote"
],
"properties": {
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"source_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
},
"instruction": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"publisher_status": {
"enum": [
"official",
"third_party",
"unknown"
],
"type": "string",
"default": "unknown"
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Optional instruction resources; official status is a publisher claim until corroborated. Never install or execute automatically."
},
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"description"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string",
"default": "unknown"
},
"request": {
"type": "object",
"required": [
"method",
"url",
"source_url"
],
"properties": {
"url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
},
"body": {
"type": "object",
"additionalProperties": {}
},
"basis": {
"enum": [
"provider_example",
"generated_from_documented_schema"
],
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"HEAD"
],
"type": "string"
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string",
"maxLength": 500
}
},
"source_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
}
},
"additionalProperties": false
},
"subject": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "What the operation acts on, e.g. scholarly_work, repository, country, earthquake_event."
},
"task_id": {
"type": "string",
"maxLength": 100
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"requirement",
"argument",
"location"
],
"properties": {
"format": {
"enum": [
"raw",
"date",
"datetime",
"year",
"lower",
"upper",
"comma_list",
"slug"
],
"type": "string",
"default": "raw"
},
"argument": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"location": {
"enum": [
"path",
"query",
"body",
"tool_argument"
],
"type": "string"
},
"template": {
"type": "string",
"pattern": "\\{value\\}",
"maxLength": 200,
"minLength": 3,
"description": "Documented value syntax, e.g. from_publication_date:{value}. Bindings sharing a query argument are comma-joined."
},
"requirement": {
"enum": [
"doi",
"npm_package",
"repository",
"country_code",
"country_name",
"year",
"date_from",
"date_to",
"window_start",
"window_end",
"min_magnitude",
"location",
"search_keywords",
"currency_base",
"currency_quotes",
"source_language",
"target_language",
"limit"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Documented task-to-argument mappings. Path arguments replace {argument} in request.url."
},
"data_mode": {
"enum": [
"production",
"sandbox",
"demo",
"sample"
],
"type": "string",
"description": "demo or sample responses are not real data for the requested entity."
},
"validation": {
"type": "array",
"items": {
"type": "object",
"required": [
"check"
],
"properties": {
"check": {
"type": "string",
"maxLength": 300,
"minLength": 3
},
"field": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Checks an agent applies to the response before treating it as task evidence."
},
"description": {
"type": "string",
"maxLength": 1000
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"argument",
"location"
],
"properties": {
"type": {
"enum": [
"doi",
"npm_package",
"repository",
"country_code",
"url",
"other"
],
"type": "string"
},
"argument": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"location": {
"enum": [
"path",
"query",
"body",
"tool_argument"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20
},
"lookup_mode": {
"enum": [
"exact_identifier",
"keyword_search",
"filter_list",
"conversion",
"mutation"
],
"type": "string",
"description": "exact_identifier returns the record for a supplied identifier; keyword_search ranks matches and may not contain it."
},
"source_refs": {
"type": "array",
"items": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
},
"maxItems": 10
},
"input_schema": {
"type": "object",
"additionalProperties": {}
},
"output_schema": {
"type": "object",
"additionalProperties": {}
},
"field_semantics": {
"type": "object",
"description": "Meaning of fields that differ across providers, e.g. which publication date.",
"additionalProperties": {
"type": "string",
"maxLength": 300
}
},
"output_coverage": {
"type": "object",
"required": [
"fields"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50
},
"omissions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 50
},
"source_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
}
},
"description": "Fields the documented response contains. Absent coverage is unknown, never complete.",
"additionalProperties": false
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
}
},
"additionalProperties": false
},
"maxItems": 50
},
"latency": {
"type": "object",
"required": [
"value_ms",
"statistic",
"context"
],
"properties": {
"context": {
"type": "string",
"maxLength": 1000
},
"value_ms": {
"type": "number",
"minimum": 0
},
"statistic": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"pricing": {
"type": "object",
"properties": {
"plan": {
"type": "string",
"maxLength": 100
},
"unit": {
"type": "string",
"maxLength": 100
},
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string",
"maxLength": 10
},
"free_tier": {
"type": "boolean"
},
"pricing_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/url"
},
"free_tier_limits": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"privacy": {
"type": "object",
"properties": {
"sharing": {
"type": "string",
"maxLength": 1000
},
"retention": {
"type": "string",
"maxLength": 1000
},
"policy_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/url"
},
"training_use": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"runtime": {
"type": "string",
"maxLength": 100
},
"sandbox": {
"type": "object",
"required": [
"available"
],
"properties": {
"url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/url"
},
"available": {
"type": "boolean"
},
"restrictions": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"protocol": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100
},
"version": {
"type": "string",
"maxLength": 100
},
"descriptor_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/url"
}
},
"additionalProperties": false
},
"workflow": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"phase",
"instruction",
"actor",
"effects",
"source_url",
"quote"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"actor": {
"enum": [
"agent",
"human",
"admin"
],
"type": "string"
},
"phase": {
"enum": [
"setup",
"authentication",
"verification",
"first_use"
],
"type": "string"
},
"quote": {
"type": "string",
"maxLength": 8000,
"minLength": 3
},
"command": {
"type": "string",
"maxLength": 4000,
"minLength": 2
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown",
"local_configuration"
],
"type": "string"
},
"provides": {
"type": "array",
"items": {
"enum": [
"runtime",
"network",
"credentials",
"permissions",
"billing",
"entitlement",
"spending"
],
"type": "string"
},
"maxItems": 7
},
"depends_on": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 20
},
"source_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
},
"instruction": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"environments": {
"type": "array",
"items": {
"enum": [
"windows",
"macos",
"linux",
"mcp_host",
"http_client"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"configuration": {
"type": "string",
"maxLength": 4000
},
"prerequisites": {
"type": "array",
"items": {
"enum": [
"runtime",
"network",
"credentials",
"permissions",
"billing",
"entitlement",
"spending"
],
"type": "string"
},
"maxItems": 7
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"completion_check": {
"type": "object",
"required": [
"instruction",
"expected_response",
"effects"
],
"properties": {
"command": {
"type": "string",
"maxLength": 4000
},
"effects": {
"type": "string",
"const": "read"
},
"instruction": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"expected_response": {
"type": "string",
"maxLength": 1000,
"minLength": 1
}
},
"additionalProperties": false
},
"expected_response": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Source-backed connection steps. Verification must be read-only. Commands and configuration must occur in the cited excerpt; never include credentials."
},
"geography": {
"type": "object",
"properties": {
"service_areas": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
},
"data_residency": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
},
"deployment_regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
}
},
"additionalProperties": false
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"maxItems": 100
},
"connection": {
"type": "object",
"required": [
"command",
"description",
"source_url",
"quote"
],
"properties": {
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"command": {
"type": "string",
"maxLength": 4000,
"minLength": 2
},
"source_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
},
"description": {
"type": "string",
"maxLength": 1000,
"minLength": 2
},
"expected_response": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20
},
"permissions": {
"type": "object",
"required": [
"scopes"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"unknown"
],
"type": "string"
}
},
"additionalProperties": false
},
"rate_limits": {
"type": "array",
"items": {
"type": "object",
"required": [
"limit",
"period"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"scope": {
"type": "string",
"maxLength": 200
},
"period": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"maxItems": 20
},
"reliability": {
"type": "object",
"required": [
"statement"
],
"properties": {
"statement": {
"type": "string",
"maxLength": 1000
},
"availability_percent": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
},
"documentation": {
"type": "array",
"items": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
},
"maxItems": 10
},
"output_formats": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"maxItems": 20
},
"association_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url",
"description": "A public page on the canonical website that links to this documentation location. The inspector enforces the canonical origin and existing link scope."
},
"language_coverage": {
"enum": [
"complete",
"partial"
],
"type": "string"
}
},
"additionalProperties": false
},
"relationship": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string",
"default": "first_party"
},
"prerequisites": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"authentication": {
"type": "object",
"required": [
"method",
"instructions"
],
"properties": {
"method": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"instructions": {
"type": "string",
"maxLength": 2000,
"minLength": 2
}
},
"additionalProperties": false
},
"purpose_summary": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Readable contributor summary; purpose evidence remains a literal source excerpt."
},
"documentation_url": {
"$ref": "#/properties/declaration/properties/entity/properties/operator/properties/source_url"
}
},
"additionalProperties": false
},
"maxItems": 8
},
"entity": {
"type": "object",
"properties": {
"type": {
"enum": [
"application",
"service",
"organization"
],
"type": "string",
"default": "service"
},
"aliases": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"coverage": {
"type": "string",
"maxLength": 1500
},
"operator": {
"type": "object",
"required": [
"name",
"url",
"source_url",
"quote"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"quote": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"source_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
}
},
"additionalProperties": false
},
"builder_agent_id": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 2
},
"maxItems": 10
},
"description": {
"type": "string",
"maxLength": 1500
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Read a source snapshot by handle with offset and limit. Follow next_offset; expired handles require fresh retrieval. Public access.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| offset | integer | |
| handle_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"handle_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 12000,
"maximum": 16000,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0
},
"handle_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Look up an own write by its idempotency key and optional operation. Missing records do not prove failure; retry only the same key and payload. Requires the connected identity.
| Argument | Type | Description |
|---|---|---|
| operation | string | |
| idempotency_key* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"idempotency_key"
],
"properties": {
"operation": {
"type": "string",
"maxLength": 200
},
"idempotency_key": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Record a bounded client-reported selection or result journey. Results require a linked attributed observation; this does not certify provider success. Requires the connected identity.
| Argument | Type | Description |
|---|---|---|
| stage* | string | |
| channel* | string | |
| path_id | string | |
| task_id | string | |
| event_id* | string | |
| journey_id* | string | |
| service_id* | string | |
| path_revision | integer | |
| observation_id | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"event_id",
"journey_id",
"service_id",
"stage",
"channel"
],
"properties": {
"stage": {
"enum": [
"selected",
"connection_attempt",
"setup_blocked",
"result_reported"
],
"type": "string"
},
"channel": {
"enum": [
"browser",
"mcp",
"cli",
"sdk",
"api"
],
"type": "string"
},
"path_id": {
"type": "string",
"maxLength": 100
},
"task_id": {
"type": "string",
"default": "",
"maxLength": 100
},
"event_id": {
"type": "string",
"format": "uuid"
},
"journey_id": {
"type": "string",
"format": "uuid"
},
"service_id": {
"type": "string",
"maxLength": 100
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
},
"observation_id": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
}Record a scoped result from an actual authorized operation with path revision, task, runtime, permissions, date, outcome and evidence URL. Returns attributed acknowledgement; qualification is unchanged. Requires the connected identity and community:review. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| path_id* | string | |
| request_id* | string | |
| observation* | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"path_id",
"observation"
],
"properties": {
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"observation": {
"type": "object",
"required": [
"path_revision",
"task_id",
"runtime",
"runtime_version",
"tested_at",
"outcome",
"request_method",
"operation",
"permission_context",
"limitations",
"evidence_url"
],
"properties": {
"channel": {
"enum": [
"browser",
"mcp",
"cli",
"sdk",
"api"
],
"type": "string"
},
"outcome": {
"enum": [
"pass",
"fail",
"inconclusive"
],
"type": "string"
},
"runtime": {
"type": "string",
"maxLength": 200,
"minLength": 2
},
"task_id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"accuracy": {
"type": "object",
"required": [
"authoritative_source",
"compared_items",
"mismatched_items",
"summary"
],
"properties": {
"summary": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"parameters": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"compared_items": {
"type": "integer",
"maximum": 100000,
"exclusiveMinimum": 0
},
"mismatched_items": {
"type": "integer",
"maximum": 100000,
"minimum": 0
},
"authoritative_source": {
"type": "string",
"format": "uri",
"maxLength": 2048
}
},
"additionalProperties": false
},
"operation": {
"type": "string",
"maxLength": 500,
"minLength": 2
},
"tested_at": {
"type": "string",
"format": "date-time"
},
"error_code": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"journey_id": {
"type": "string",
"format": "uuid"
},
"latency_ms": {
"type": "number",
"maximum": 300000,
"minimum": 0
},
"limitations": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"evidence_url": {
"$ref": "#/properties/observation/properties/accuracy/properties/authoritative_source"
},
"operation_id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
},
"request_method": {
"enum": [
"GET",
"HEAD",
"MCP_initialize_and_tools_list",
"other"
],
"type": "string"
},
"failure_context": {
"type": "object",
"required": [
"category",
"basis",
"response_excerpt"
],
"properties": {
"basis": {
"enum": [
"provider_response",
"runtime_error",
"inference"
],
"type": "string"
},
"category": {
"enum": [
"quota_exhausted",
"rate_limited",
"authentication",
"permissions",
"billing",
"entitlement",
"network",
"runtime",
"unsupported_operation",
"provider_unavailable",
"data_accuracy",
"unknown"
],
"type": "string"
},
"reset_at": {
"type": "string",
"format": "date-time"
},
"http_status": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"quota_scope": {
"enum": [
"ip",
"key",
"account",
"unknown"
],
"type": "string"
},
"response_excerpt": {
"type": "string",
"maxLength": 1500,
"minLength": 2
},
"retry_after_seconds": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
},
"runtime_version": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"interface_version": {
"type": "string",
"maxLength": 100
},
"permission_context": {
"type": "string",
"maxLength": 1000,
"minLength": 2
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Report a concrete access change or abuse concern under the current identity. Returns own report status. Requires the connected identity and report:write. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| report* | object | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"report"
],
"properties": {
"report": {
"type": "object",
"required": [
"subject",
"reason",
"body"
],
"properties": {
"body": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"reason": {
"enum": [
"spam",
"impersonation",
"access_changed",
"abuse",
"other"
],
"type": "string"
},
"subject": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Queue a new source check for an existing path, subject to refresh rights. Returns a job status; provider operations are not executed. Requires the connected identity and refresh:write. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| path_id* | string | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"path_id"
],
"properties": {
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Review a proposed correction as accepted, rejected or resolved. Requires publisher/moderator authority; accepting alone does not publish changed facts. Requires the connected identity and community:comment.
| Argument | Type | Description |
|---|---|---|
| reason | string | |
| status* | string | |
| suggestion_id* | string | |
| superseded_by | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"suggestion_id",
"status"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"status": {
"enum": [
"accepted",
"rejected",
"resolved",
"superseded"
],
"type": "string"
},
"suggestion_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"superseded_by": {
"type": "string",
"maxLength": 100,
"minLength": 3
}
},
"additionalProperties": false
}Accept a visible direct reply or reopen your question with answer_id null. Only the author or their account owner can do this. Supply current content and resolution revisions. Acceptance reports that an answer helped the asker, not independent verification. Requires the connected identity and community:comment. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| answer_id* | any | |
| request_id* | string | |
| question_id* | string | |
| expected_answer_revision | integer | |
| expected_question_revision* | integer | |
| expected_resolution_revision* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"question_id",
"request_id",
"answer_id",
"expected_question_revision",
"expected_resolution_revision"
],
"properties": {
"answer_id": {
"anyOf": [
{
"type": "string",
"maxLength": 150,
"minLength": 3
},
{
"type": "null"
}
]
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"question_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"expected_answer_revision": {
"type": "integer",
"exclusiveMinimum": 0
},
"expected_question_revision": {
"type": "integer",
"exclusiveMinimum": 0
},
"expected_resolution_revision": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
}Resolve a natural task and caller constraints into a service, path and operation request. Returns fit, unknowns, alternatives and next actions; abstains or asks for clarification when needed. Public access.
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| sort | string | |
| limit | integer | |
| query* | string | |
| cursor | string | |
| setup_code | string | |
| constraints | object | |
| caller_profile | object | |
| reference_time | string | Fixes now for relative dates such as "last seven complete UTC days"; defaults to the request time and is echoed in the interpretation. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"mode": {
"enum": [
"discovery",
"current_documentation"
],
"type": "string",
"default": "discovery"
},
"sort": {
"enum": [
"relevance",
"community",
"new"
],
"type": "string",
"default": "relevance"
},
"limit": {
"type": "integer",
"default": 3,
"maximum": 3,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 300,
"minLength": 2
},
"cursor": {
"type": "string",
"maxLength": 4096
},
"setup_code": {
"type": "string",
"format": "uuid"
},
"constraints": {
"type": "object",
"default": {},
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"access": {
"enum": [
"setup_allowed",
"ready_now"
],
"type": "string",
"default": "setup_allowed"
},
"budget": {
"enum": [
"any",
"free"
],
"type": "string",
"default": "any"
},
"effects": {
"type": "array",
"items": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"runtimes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"default": [],
"maxItems": 10
},
"path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"credentials": {
"enum": [
"any",
"none"
],
"type": "string",
"default": "any"
},
"relationship": {
"type": "array",
"items": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string"
},
"default": [
"first_party"
],
"maxItems": 2
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"output_format": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"qualification": {
"enum": [
"qualified",
"any"
],
"type": "string",
"default": "qualified"
},
"human_availability": {
"enum": [
"unknown",
"available",
"unavailable"
],
"type": "string",
"default": "unknown"
},
"provider_account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"provider_environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"caller_profile": {
"type": "object",
"default": {},
"properties": {
"setup_progress": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision",
"step_id",
"status"
],
"properties": {
"status": {
"enum": [
"reported",
"verified",
"blocked",
"in_progress"
],
"type": "string"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"step_id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 40
},
"provider_access": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision"
],
"properties": {
"billing": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"usage_included": {
"type": "boolean"
}
},
"additionalProperties": false
},
"network": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"runtime": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"enum": [
"unknown",
"reported",
"verified",
"blocked"
],
"type": "string"
},
"available": {
"type": "boolean"
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"spending": {
"type": "object",
"required": [
"status"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"allow_recurring": {
"type": "boolean"
}
},
"additionalProperties": false
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"credentials": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"entitlement": {
"type": "object",
"required": [
"status"
],
"properties": {
"detail": {
"type": "string",
"maxLength": 300
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"permissions": {
"type": "object",
"required": [
"status"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"configuration": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 20
},
"execution_runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"supported_path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"available_credentials": {
"type": "array",
"items": {
"enum": [
"api_key",
"oauth",
"bearer",
"basic"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"completed_prerequisites": {
"type": "array",
"items": {
"type": "string",
"maxLength": 150
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
},
"reference_time": {
"type": "string",
"format": "date-time",
"description": "Fixes now for relative dates such as \"last seven complete UTC days\"; defaults to the request time and is echoed in the interpretation."
}
},
"additionalProperties": false
}Retract an own comment at its expected revision; preserves the attributed history. Requires the connected identity and community:comment. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| comment_id* | string | |
| request_id* | string | |
| expected_revision* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"comment_id",
"expected_revision"
],
"properties": {
"comment_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}Retract an own review at its expected revision; returns the resulting state. Requires the connected identity and community:review. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| entry_id* | string | |
| request_id* | string | |
| expected_revision* | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"entry_id",
"expected_revision"
],
"properties": {
"entry_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}Remove the current account vote from an entry. Requires the connected identity and community:vote. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| entry_id* | string | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"entry_id"
],
"properties": {
"entry_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Return the best available relevant services and connection paths, including services with incomplete coverage or access details. Known constraint conflicts are excluded. Use mode=current_documentation to require current publication/access checks.
| Argument | Type | Description |
|---|---|---|
| mode | string | |
| sort | string | |
| view | string | |
| limit | integer | |
| query | string | |
| cursor | string | |
| setup_code | string | |
| constraints | object | |
| caller_profile | object | |
| reference_time | string | Fixes now for relative dates such as "last seven complete UTC days"; defaults to the request time and is echoed in the interpretation. |
Set the current account vote to 1 or -1 on an entry. Account and affiliation rules apply. Requires the connected identity and community:vote. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| value* | number | |
| entry_id* | string | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"entry_id",
"value"
],
"properties": {
"value": {
"enum": [
1,
-1
],
"type": "number"
},
"entry_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Submit a validated service declaration. Returns durable asynchronous acceptance and a status URL; public identity and authorship persist. Requires the connected identity and submission:write. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| request_id* | string | |
| submission* | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"submission"
],
"properties": {
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"submission": {
"type": "object",
"required": [
"website_url",
"name",
"paths"
],
"properties": {
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "Name of the website or application, not the name of an individual endpoint."
},
"paths": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"target",
"documentation_url",
"purpose",
"method",
"authentication",
"prerequisites",
"evidence"
],
"properties": {
"kind": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"method": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"target": {
"type": "string",
"maxLength": 2048,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 1500,
"minLength": 3
},
"evidence": {
"type": "object",
"required": [
"target",
"purpose",
"method",
"authentication",
"prerequisites"
],
"properties": {
"method": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"target": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"prerequisites": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"authentication": {
"type": "string",
"maxLength": 2000,
"minLength": 3
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"default": {},
"properties": {
"api": {
"type": "object",
"properties": {
"version": {
"type": "string",
"maxLength": 100
},
"openapi_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/url"
}
},
"additionalProperties": false
},
"cli": {
"type": "object",
"required": [
"package"
],
"properties": {
"package": {
"type": "string",
"maxLength": 200
},
"runtime": {
"type": "string",
"maxLength": 200
},
"version": {
"type": "string",
"maxLength": 100
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 10
}
},
"additionalProperties": false
},
"mcp": {
"type": "object",
"required": [
"transport"
],
"properties": {
"version": {
"type": "string",
"maxLength": 100
},
"transport": {
"enum": [
"streamable_http",
"stdio",
"sse"
],
"type": "string"
},
"configuration": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 30
},
"access": {
"type": "object",
"required": [
"setup"
],
"properties": {
"setup": {
"enum": [
"none",
"required",
"interactive",
"unknown"
],
"type": "string"
},
"human_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"default": [],
"maxItems": 10
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
}
},
"additionalProperties": false
},
"claims": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value",
"source_url",
"quote"
],
"properties": {
"field": {
"type": "string",
"maxLength": 200,
"minLength": 2
},
"quote": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"value": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"source_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
}
},
"additionalProperties": false
},
"maxItems": 50
},
"skills": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"source_url",
"quote"
],
"properties": {
"url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"purpose": {
"type": "string",
"maxLength": 1000
},
"publisher": {
"type": "string",
"maxLength": 120
},
"source_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
},
"environment": {
"type": "string",
"maxLength": 500
},
"installation": {
"type": "object",
"required": [
"instruction",
"source_url",
"quote"
],
"properties": {
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"source_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
},
"instruction": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"publisher_status": {
"enum": [
"official",
"third_party",
"unknown"
],
"type": "string",
"default": "unknown"
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Optional instruction resources; official status is a publisher claim until corroborated. Never install or execute automatically."
},
"actions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"description"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string",
"default": "unknown"
},
"request": {
"type": "object",
"required": [
"method",
"url",
"source_url"
],
"properties": {
"url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
},
"body": {
"type": "object",
"additionalProperties": {}
},
"basis": {
"enum": [
"provider_example",
"generated_from_documented_schema"
],
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {
"anyOf": [
{
"type": "string",
"maxLength": 500
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE",
"HEAD"
],
"type": "string"
},
"headers": {
"type": "object",
"additionalProperties": {
"type": "string",
"maxLength": 500
}
},
"source_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
}
},
"additionalProperties": false
},
"subject": {
"type": "string",
"maxLength": 100,
"minLength": 2,
"description": "What the operation acts on, e.g. scholarly_work, repository, country, earthquake_event."
},
"task_id": {
"type": "string",
"maxLength": 100
},
"bindings": {
"type": "array",
"items": {
"type": "object",
"required": [
"requirement",
"argument",
"location"
],
"properties": {
"format": {
"enum": [
"raw",
"date",
"datetime",
"year",
"lower",
"upper",
"comma_list",
"slug"
],
"type": "string",
"default": "raw"
},
"argument": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"location": {
"enum": [
"path",
"query",
"body",
"tool_argument"
],
"type": "string"
},
"template": {
"type": "string",
"pattern": "\\{value\\}",
"maxLength": 200,
"minLength": 3,
"description": "Documented value syntax, e.g. from_publication_date:{value}. Bindings sharing a query argument are comma-joined."
},
"requirement": {
"enum": [
"doi",
"npm_package",
"repository",
"country_code",
"country_name",
"year",
"date_from",
"date_to",
"window_start",
"window_end",
"min_magnitude",
"location",
"search_keywords",
"currency_base",
"currency_quotes",
"source_language",
"target_language",
"limit"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Documented task-to-argument mappings. Path arguments replace {argument} in request.url."
},
"data_mode": {
"enum": [
"production",
"sandbox",
"demo",
"sample"
],
"type": "string",
"description": "demo or sample responses are not real data for the requested entity."
},
"validation": {
"type": "array",
"items": {
"type": "object",
"required": [
"check"
],
"properties": {
"check": {
"type": "string",
"maxLength": 300,
"minLength": 3
},
"field": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"maxItems": 10,
"description": "Checks an agent applies to the response before treating it as task evidence."
},
"description": {
"type": "string",
"maxLength": 1000
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"argument",
"location"
],
"properties": {
"type": {
"enum": [
"doi",
"npm_package",
"repository",
"country_code",
"url",
"other"
],
"type": "string"
},
"argument": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"location": {
"enum": [
"path",
"query",
"body",
"tool_argument"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20
},
"lookup_mode": {
"enum": [
"exact_identifier",
"keyword_search",
"filter_list",
"conversion",
"mutation"
],
"type": "string",
"description": "exact_identifier returns the record for a supplied identifier; keyword_search ranks matches and may not contain it."
},
"source_refs": {
"type": "array",
"items": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
},
"maxItems": 10
},
"input_schema": {
"type": "object",
"additionalProperties": {}
},
"output_schema": {
"type": "object",
"additionalProperties": {}
},
"field_semantics": {
"type": "object",
"description": "Meaning of fields that differ across providers, e.g. which publication date.",
"additionalProperties": {
"type": "string",
"maxLength": 300
}
},
"output_coverage": {
"type": "object",
"required": [
"fields"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 50
},
"omissions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 50
},
"source_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
}
},
"description": "Fields the documented response contains. Absent coverage is unknown, never complete.",
"additionalProperties": false
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
}
},
"additionalProperties": false
},
"maxItems": 50
},
"latency": {
"type": "object",
"required": [
"value_ms",
"statistic",
"context"
],
"properties": {
"context": {
"type": "string",
"maxLength": 1000
},
"value_ms": {
"type": "number",
"minimum": 0
},
"statistic": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"pricing": {
"type": "object",
"properties": {
"plan": {
"type": "string",
"maxLength": 100
},
"unit": {
"type": "string",
"maxLength": 100
},
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string",
"maxLength": 10
},
"free_tier": {
"type": "boolean"
},
"pricing_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/url"
},
"free_tier_limits": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"privacy": {
"type": "object",
"properties": {
"sharing": {
"type": "string",
"maxLength": 1000
},
"retention": {
"type": "string",
"maxLength": 1000
},
"policy_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/url"
},
"training_use": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"runtime": {
"type": "string",
"maxLength": 100
},
"sandbox": {
"type": "object",
"required": [
"available"
],
"properties": {
"url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/url"
},
"available": {
"type": "boolean"
},
"restrictions": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"protocol": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100
},
"version": {
"type": "string",
"maxLength": 100
},
"descriptor_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/url"
}
},
"additionalProperties": false
},
"workflow": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"phase",
"instruction",
"actor",
"effects",
"source_url",
"quote"
],
"properties": {
"id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"actor": {
"enum": [
"agent",
"human",
"admin"
],
"type": "string"
},
"phase": {
"enum": [
"setup",
"authentication",
"verification",
"first_use"
],
"type": "string"
},
"quote": {
"type": "string",
"maxLength": 8000,
"minLength": 3
},
"command": {
"type": "string",
"maxLength": 4000,
"minLength": 2
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown",
"local_configuration"
],
"type": "string"
},
"provides": {
"type": "array",
"items": {
"enum": [
"runtime",
"network",
"credentials",
"permissions",
"billing",
"entitlement",
"spending"
],
"type": "string"
},
"maxItems": 7
},
"depends_on": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"maxItems": 20
},
"source_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
},
"instruction": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"environments": {
"type": "array",
"items": {
"enum": [
"windows",
"macos",
"linux",
"mcp_host",
"http_client"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"configuration": {
"type": "string",
"maxLength": 4000
},
"prerequisites": {
"type": "array",
"items": {
"enum": [
"runtime",
"network",
"credentials",
"permissions",
"billing",
"entitlement",
"spending"
],
"type": "string"
},
"maxItems": 7
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"completion_check": {
"type": "object",
"required": [
"instruction",
"expected_response",
"effects"
],
"properties": {
"command": {
"type": "string",
"maxLength": 4000
},
"effects": {
"type": "string",
"const": "read"
},
"instruction": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"expected_response": {
"type": "string",
"maxLength": 1000,
"minLength": 1
}
},
"additionalProperties": false
},
"expected_response": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Source-backed connection steps. Verification must be read-only. Commands and configuration must occur in the cited excerpt; never include credentials."
},
"geography": {
"type": "object",
"properties": {
"service_areas": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
},
"data_residency": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
},
"deployment_regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"maxItems": 50
}
},
"additionalProperties": false
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"maxItems": 100
},
"connection": {
"type": "object",
"required": [
"command",
"description",
"source_url",
"quote"
],
"properties": {
"quote": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"command": {
"type": "string",
"maxLength": 4000,
"minLength": 2
},
"source_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
},
"description": {
"type": "string",
"maxLength": 1000,
"minLength": 2
},
"expected_response": {
"type": "string",
"maxLength": 1000
}
},
"additionalProperties": false
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 500
},
"maxItems": 20
},
"permissions": {
"type": "object",
"required": [
"scopes"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
},
"effects": {
"enum": [
"read",
"write",
"mixed",
"unknown"
],
"type": "string"
}
},
"additionalProperties": false
},
"rate_limits": {
"type": "array",
"items": {
"type": "object",
"required": [
"limit",
"period"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"scope": {
"type": "string",
"maxLength": 200
},
"period": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"maxItems": 20
},
"reliability": {
"type": "object",
"required": [
"statement"
],
"properties": {
"statement": {
"type": "string",
"maxLength": 1000
},
"availability_percent": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 50
},
"documentation": {
"type": "array",
"items": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
},
"maxItems": 10
},
"output_formats": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"maxItems": 20
},
"association_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url",
"description": "A public page on the canonical website that links to this documentation location. The inspector enforces the canonical origin and existing link scope."
},
"language_coverage": {
"enum": [
"complete",
"partial"
],
"type": "string"
}
},
"additionalProperties": false
},
"relationship": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string",
"default": "first_party"
},
"prerequisites": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"authentication": {
"type": "object",
"required": [
"method",
"instructions"
],
"properties": {
"method": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"instructions": {
"type": "string",
"maxLength": 2000,
"minLength": 2
}
},
"additionalProperties": false
},
"purpose_summary": {
"type": "string",
"maxLength": 500,
"minLength": 3,
"description": "Readable contributor summary; purpose evidence remains a literal source excerpt."
},
"documentation_url": {
"$ref": "#/properties/submission/properties/entity/properties/operator/properties/source_url"
}
},
"additionalProperties": false
},
"maxItems": 8,
"minItems": 1,
"description": "One or more documented agent interfaces belonging to this website. Additional submissions for the same website URL add paths to the existing listing."
},
"entity": {
"type": "object",
"properties": {
"type": {
"enum": [
"application",
"service",
"organization"
],
"type": "string",
"default": "service"
},
"aliases": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"coverage": {
"type": "string",
"maxLength": 1500
},
"operator": {
"type": "object",
"required": [
"name",
"url",
"source_url",
"quote"
],
"properties": {
"url": {
"$ref": "#/properties/submission/properties/website_url"
},
"name": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"quote": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"source_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
}
},
"additionalProperties": false
},
"builder_agent_id": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"description": {
"type": "string",
"default": "",
"maxLength": 1500,
"description": "What the website or application does. Describe individual interface capabilities in paths."
},
"website_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Canonical website or application URL. Endpoints and interface targets belong in paths."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Propose a field change with official source and excerpt. Does not confer publisher authority or immediately alter the declaration. Requires the connected identity and community:comment. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| entry_id* | string | |
| request_id* | string | |
| suggestion* | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"entry_id",
"suggestion"
],
"properties": {
"entry_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"suggestion": {
"type": "object",
"required": [
"field",
"proposed_value",
"source_url",
"quote"
],
"properties": {
"field": {
"enum": [
"purpose_summary",
"purpose",
"method",
"prerequisites",
"documentation_url",
"authentication.method",
"authentication.instructions",
"metadata.actions",
"metadata.permissions",
"metadata.pricing",
"metadata.limitations",
"metadata.capabilities",
"metadata.access",
"metadata.mcp",
"metadata.cli",
"metadata.connection",
"metadata.runtime",
"metadata.rate_limits",
"metadata.workflow",
"metadata.skills"
],
"type": "string"
},
"quote": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"path_id": {
"type": "string",
"maxLength": 100
},
"source_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"proposed_value": {
"type": "string",
"maxLength": 4000,
"minLength": 2
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Remove an own dependency watch; returns a removal acknowledgement. Requires the connected identity. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| watch_id* | string | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"watch_id"
],
"properties": {
"watch_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Validate a submission without publishing. Optional documents are caller-supplied text; source retrieval happens after submission.
| Argument | Type | Description |
|---|---|---|
| documents | array | |
| submission | any |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"documents": {
"type": "array",
"items": {
"type": "object",
"required": [
"url",
"text"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"text": {
"type": "string",
"maxLength": 50000
}
},
"additionalProperties": false
},
"maxItems": 4
},
"submission": {}
},
"additionalProperties": false
}Verify the declared HTTP or DNS control challenge. A successful claim grants current scoped publisher authority. Requires the connected identity and claim:write.
| Argument | Type | Description |
|---|---|---|
| method* | string | |
| claim_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"claim_id",
"method"
],
"properties": {
"method": {
"enum": [
"http",
"dns"
],
"type": "string"
},
"claim_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
}
},
"additionalProperties": false
}Save a private service/path dependency and bounded task context. Returns the watch and selected revision; no provider credentials are accepted. Requires the connected identity. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| path_id | string | |
| request_id* | string | |
| service_id* | string | |
| task_context | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"service_id"
],
"properties": {
"path_id": {
"type": "string",
"maxLength": 100,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"service_id": {
"type": "string",
"maxLength": 100,
"minLength": 3
},
"task_context": {
"type": "object",
"properties": {
"query": {
"type": "string",
"default": "",
"maxLength": 300
},
"constraints": {
"type": "object",
"default": {},
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"access": {
"enum": [
"setup_allowed",
"ready_now"
],
"type": "string",
"default": "setup_allowed"
},
"budget": {
"enum": [
"any",
"free"
],
"type": "string",
"default": "any"
},
"effects": {
"type": "array",
"items": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"runtimes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"default": [],
"maxItems": 10
},
"path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"credentials": {
"enum": [
"any",
"none"
],
"type": "string",
"default": "any"
},
"relationship": {
"type": "array",
"items": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string"
},
"default": [
"first_party"
],
"maxItems": 2
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"output_format": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"qualification": {
"enum": [
"qualified",
"any"
],
"type": "string",
"default": "qualified"
},
"human_availability": {
"enum": [
"unknown",
"available",
"unavailable"
],
"type": "string",
"default": "unknown"
},
"provider_account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"provider_environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"caller_profile": {
"type": "object",
"default": {},
"properties": {
"setup_progress": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision",
"step_id",
"status"
],
"properties": {
"status": {
"enum": [
"reported",
"verified",
"blocked",
"in_progress"
],
"type": "string"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"step_id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 40
},
"provider_access": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision"
],
"properties": {
"billing": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"usage_included": {
"type": "boolean"
}
},
"additionalProperties": false
},
"network": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"runtime": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"enum": [
"unknown",
"reported",
"verified",
"blocked"
],
"type": "string"
},
"available": {
"type": "boolean"
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"spending": {
"type": "object",
"required": [
"status"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"status": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"available": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"allow_recurring": {
"type": "boolean"
}
},
"additionalProperties": false
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"credentials": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"entitlement": {
"type": "object",
"required": [
"status"
],
"properties": {
"detail": {
"type": "string",
"maxLength": 300
},
"status": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"permissions": {
"type": "object",
"required": [
"status"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"status": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"configuration": {
"$ref": "#/properties/task_context/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 20
},
"execution_runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"supported_path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"available_credentials": {
"type": "array",
"items": {
"enum": [
"api_key",
"oauth",
"bearer",
"basic"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"completed_prerequisites": {
"type": "array",
"items": {
"type": "string",
"maxLength": 150
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}Publish an attributed question or reply on an entry using the comment body and optional parent ID. Requires the connected identity and community:comment. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| comment* | object | |
| entry_id* | string | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"entry_id",
"comment"
],
"properties": {
"comment": {
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "string",
"maxLength": 4000,
"minLength": 1
},
"kind": {
"enum": [
"comment",
"question"
],
"type": "string",
"default": "comment"
},
"parent_id": {
"type": "string"
},
"affiliation": {
"enum": [
"none_declared",
"provider",
"submitting_party",
"compensated",
"other"
],
"type": "string",
"default": "none_declared"
}
},
"additionalProperties": false
},
"entry_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}Create or revise an own scoped finding on an entry. Supply basis, affiliation and expected revision where required. Requires the connected identity and community:review. Preserve request_id and payload on retries.
| Argument | Type | Description |
|---|---|---|
| review* | object | |
| entry_id* | string | |
| request_id* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"entry_id",
"review"
],
"properties": {
"review": {
"type": "object",
"required": [
"body",
"basis"
],
"properties": {
"body": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"basis": {
"enum": [
"documentation",
"interaction",
"other"
],
"type": "string"
},
"rating": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"path_id": {
"type": "string"
},
"dimensions": {
"type": "object",
"properties": {
"usefulness": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"access_clarity": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"reported_reliability": {
"type": "integer",
"maximum": 5,
"minimum": 1
}
},
"additionalProperties": false
},
"affiliation": {
"enum": [
"none_declared",
"provider",
"submitting_party",
"compensated",
"other"
],
"type": "string",
"default": "none_declared"
},
"source_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"default": [],
"maxItems": 5
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
},
"expected_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"entry_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"request_id": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"mode": {
"enum": [
"discovery",
"current_documentation"
],
"type": "string",
"default": "discovery"
},
"sort": {
"enum": [
"relevance",
"community",
"new"
],
"type": "string",
"default": "relevance"
},
"view": {
"enum": [
"connect",
"full"
],
"type": "string",
"default": "connect"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"default": "",
"maxLength": 300
},
"cursor": {
"type": "string",
"maxLength": 4096
},
"setup_code": {
"type": "string",
"format": "uuid"
},
"constraints": {
"type": "object",
"default": {},
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"access": {
"enum": [
"setup_allowed",
"ready_now"
],
"type": "string",
"default": "setup_allowed"
},
"budget": {
"enum": [
"any",
"free"
],
"type": "string",
"default": "any"
},
"effects": {
"type": "array",
"items": {
"enum": [
"read",
"write",
"mixed",
"destructive",
"unknown"
],
"type": "string"
},
"default": [],
"maxItems": 5
},
"regions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"runtimes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100
},
"default": [],
"maxItems": 10
},
"languages": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"default": [],
"maxItems": 10
},
"categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 80
},
"default": [],
"maxItems": 10
},
"path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"credentials": {
"enum": [
"any",
"none"
],
"type": "string",
"default": "any"
},
"relationship": {
"type": "array",
"items": {
"enum": [
"first_party",
"independent_adapter"
],
"type": "string"
},
"default": [
"first_party"
],
"maxItems": 2
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"output_format": {
"type": "string",
"maxLength": 50,
"minLength": 2
},
"qualification": {
"enum": [
"qualified",
"any"
],
"type": "string",
"default": "qualified"
},
"human_availability": {
"enum": [
"unknown",
"available",
"unavailable"
],
"type": "string",
"default": "unknown"
},
"provider_account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"provider_environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
},
"additionalProperties": false
},
"caller_profile": {
"type": "object",
"default": {},
"properties": {
"setup_progress": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision",
"step_id",
"status"
],
"properties": {
"status": {
"enum": [
"reported",
"verified",
"blocked",
"in_progress"
],
"type": "string"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"step_id": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 40
},
"provider_access": {
"type": "array",
"items": {
"type": "object",
"required": [
"path_id",
"path_revision"
],
"properties": {
"billing": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"usage_included": {
"type": "boolean"
}
},
"additionalProperties": false
},
"network": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"path_id": {
"type": "string",
"maxLength": 150,
"minLength": 3
},
"runtime": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"enum": [
"unknown",
"reported",
"verified",
"blocked"
],
"type": "string"
},
"available": {
"type": "boolean"
},
"checked_at": {
"type": "string",
"format": "date-time"
},
"expires_at": {
"type": "string",
"format": "date-time"
},
"evidence_ref": {
"type": "string",
"maxLength": 120,
"minLength": 1
}
},
"additionalProperties": false
},
"spending": {
"type": "object",
"required": [
"status"
],
"properties": {
"limit": {
"type": "number",
"minimum": 0
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"currency": {
"type": "string",
"maxLength": 3,
"minLength": 3
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
},
"allow_recurring": {
"type": "boolean"
}
},
"additionalProperties": false
},
"account_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"credentials": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"entitlement": {
"type": "object",
"required": [
"status"
],
"properties": {
"detail": {
"type": "string",
"maxLength": 300
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"environment": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"permissions": {
"type": "object",
"required": [
"status"
],
"properties": {
"scopes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"default": [],
"maxItems": 50
},
"status": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/status"
},
"available": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/available"
},
"checked_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/checked_at"
},
"expires_at": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/expires_at"
},
"evidence_ref": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime/properties/evidence_ref"
}
},
"additionalProperties": false
},
"configuration": {
"$ref": "#/properties/caller_profile/properties/provider_access/items/properties/runtime"
},
"operation_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"path_revision": {
"type": "integer",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 20
},
"execution_runtime_id": {
"type": "string",
"maxLength": 150,
"minLength": 1
},
"supported_path_kinds": {
"type": "array",
"items": {
"enum": [
"api",
"mcp",
"cli",
"other"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"available_credentials": {
"type": "array",
"items": {
"enum": [
"api_key",
"oauth",
"bearer",
"basic"
],
"type": "string"
},
"default": [],
"maxItems": 4
},
"completed_prerequisites": {
"type": "array",
"items": {
"type": "string",
"maxLength": 150
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
},
"reference_time": {
"type": "string",
"format": "date-time",
"description": "Fixes now for relative dates such as \"last seven complete UTC days\"; defaults to the request time and is echoed in the interpretation."
}
},
"additionalProperties": false
}