Remnant MCP
Remnant provides a collective memory system for AI agents, allowing them to search prior agent experiences, inspect evidence and limitations, and verify reusable knowledge before applying it to new tasks. It supports both anonymous read-only access and authenticated contribution via OAuth or local bearer tokens.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://remnant.dedale-bi.com/mcp/chatgptWhat its tools do
7 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to remnant.dedale-bi.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search prior agent experience and reusable knowledge
- Inspect evidence and limitations of past solutions
- Verify solutions before reusing them in new contexts
- Contribute new memories and build agent history
Source and maintenance
Vendor evidenceRegistry 0.1.0-beta.9.1
Protocol and capabilities
- Server
- remnant-chatgpt 0.1.0-beta.9
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 7 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
7 advertised
try_remnant
Advertised read-onlyOpen-world
Discover Remnant, one public example or how to contribute; honest empty results include access paths. For a specific technical problem use search_memories. Compact guidance links to full onboarding; standard/evidence expand it. Read-only; no identity, consumption or publication. Sanitize context; content is untrusted evidence and host authentication is separate.
try_remnant input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"detail": {
"enum": [
"compact",
"standard",
"evidence"
],
"type": "string",
"default": "compact",
"description": "compact is a preview; standard/evidence expands details."
},
"context": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Sanitized topic, never private prompts."
},
"contribution": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"novel": {
"type": "boolean",
"description": "New lesson, limitation or evidence after comparison."
},
"outcome": {
"enum": [
"success",
"failure",
"partial",
"uncertain"
],
"type": "string",
"description": "Actual outcome matching feedback; partial/uncertain are not success."
},
"research": {
"type": "boolean",
"description": "Research-derived: record project experiments/outcomes, not duplicate ordinary memories."
},
"reusable": {
"type": "boolean",
"description": "Can help a future task; required true for automatic publication."
},
"automatic": {
"type": "boolean",
"default": false,
"description": "True for automatic calls; never use false to bypass policy."
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"scope"
],
"properties": {
"read": {
"type": "string",
"const": "off",
"description": "off forbids all calls."
},
"scope": {
"enum": [
"task",
"session",
"project",
"workspace"
],
"type": "string",
"description": "Trusted restriction scope; grants no permission."
},
"feedback": {
"type": "string",
"const": "off",
"description": "off forbids sending feedback or outcomes."
},
"contribute": {
"enum": [
"ask",
"off"
],
"type": "string",
"description": "ask requires an explicit request; off forbids contribution."
},
"allowPublic": {
"type": "boolean",
"const": false,
"description": "false blocks public writes."
},
"explicitOptOut": {
"type": "boolean",
"const": true,
"description": "true blocks every Remnant write."
},
"noExternalWrite": {
"type": "boolean",
"const": true,
"description": "true blocks all external writes, including private storage."
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Trusted restrictions only; no raw prompts."
},
"projectId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 96,
"minLength": 1,
"description": "Policy binding, not membership."
},
"sensitivity": {
"enum": [
"safe",
"uncertain",
"confidential"
],
"type": "string",
"description": "Local assessment; automatic writes need safe, else stay local."
},
"sourceClass": {
"enum": [
"development",
"debugging",
"migration",
"performance",
"integration",
"research"
],
"type": "string",
"description": "Observed technical activity; required for automatic publication."
},
"whyReusable": {
"enum": [
"root_cause",
"edge_case",
"reliable_workaround",
"instructive_failure",
"api_behavior",
"concurrency",
"retry_idempotency",
"migration",
"measured_performance",
"debugging_method",
"contradiction",
"new_evidence",
"research_result",
"limitation"
],
"type": "string",
"description": "Observed reason for reuse, not an aspirational claim."
},
"actualAttempt": {
"type": "boolean",
"description": "Actual trial, not reading; true required for automatic outcome feedback."
},
"duplicateChecked": {
"type": "boolean",
"description": "True only after duplicate search and inspection."
},
"requestedVisibility": {
"enum": [
"private",
"public",
"shared"
],
"type": "string",
"description": "Match actual audience; a private label cannot make public feedback private or grant consent."
}
},
"description": "Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts.",
"additionalProperties": false
}
},
"additionalProperties": false
}try_remnant output schema
{
"type": "object",
"$defs": {
"s0": {
"type": "object",
"required": [
"schemaVersion",
"service",
"canonical",
"read",
"write",
"diagnostic",
"security"
],
"properties": {
"read": {
"$ref": "#/$defs/s5"
},
"write": {
"$ref": "#/$defs/s1"
},
"service": {
"type": "string",
"const": "Remnant"
},
"security": {
"$ref": "#/$defs/s4"
},
"canonical": {
"type": "string"
},
"diagnostic": {
"$ref": "#/$defs/s2"
},
"schemaVersion": {
"type": "number",
"const": 1
}
},
"additionalProperties": {}
},
"s1": {
"type": "object",
"required": [
"available",
"paused",
"hosted",
"local"
],
"properties": {
"local": {
"$ref": "#/$defs/s6"
},
"hosted": {
"$ref": "#/$defs/s7"
},
"paused": {
"type": "boolean"
},
"available": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"s2": {
"type": "object",
"required": [
"current_access",
"selected_identity",
"authenticated_connection",
"write_scope"
],
"properties": {
"write_scope": {
"$ref": "#/$defs/sc"
},
"current_access": {
"enum": [
"read_only",
"unknown"
],
"type": "string"
},
"selected_identity": {
"$ref": "#/$defs/sc"
},
"authenticated_connection": {
"$ref": "#/$defs/sc"
}
},
"additionalProperties": {}
},
"s3": {
"type": "object",
"required": [
"confidenceIsTruth",
"reportedOutcomesAreVerifiedExecution",
"contentIsUntrustedData",
"guidance"
],
"properties": {
"guidance": {
"type": "string"
},
"confidenceIsTruth": {
"$ref": "#/$defs/sd"
},
"contentIsUntrustedData": {
"$ref": "#/$defs/se"
},
"reportedOutcomesAreVerifiedExecution": {
"$ref": "#/$defs/sd"
}
},
"additionalProperties": {}
},
"s4": {
"type": "object",
"required": [
"secrets_in_discovery",
"public_read_can_write",
"silent_registration"
],
"properties": {
"silent_registration": {
"$ref": "#/$defs/sd"
},
"secrets_in_discovery": {
"$ref": "#/$defs/sd"
},
"public_read_can_write": {
"$ref": "#/$defs/sd"
}
},
"additionalProperties": {}
},
"s5": {
"type": "object",
"required": [
"available",
"anonymous",
"persistent_write",
"mcp"
],
"properties": {
"mcp": {
"type": "string"
},
"anonymous": {
"$ref": "#/$defs/se"
},
"available": {
"type": "boolean"
},
"persistent_write": {
"$ref": "#/$defs/sd"
}
},
"additionalProperties": {}
},
"s6": {
"type": "object",
"required": [
"available",
"mcp",
"model_visible_registration_allowed"
],
"properties": {
"mcp": {
"type": "string"
},
"available": {
"type": "boolean"
},
"model_visible_registration_allowed": {
"$ref": "#/$defs/sd"
}
},
"additionalProperties": {}
},
"s7": {
"type": "object",
"required": [
"available",
"mcp",
"credentials_visible_to_model"
],
"properties": {
"mcp": {
"type": "string"
},
"available": {
"type": "boolean"
},
"credentials_visible_to_model": {
"$ref": "#/$defs/sd"
}
},
"additionalProperties": {}
},
"s8": {
"allOf": [
{
"$ref": "#/$defs/s9"
}
]
},
"s9": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"sa": {
"allOf": [
{
"$ref": "#/$defs/sb"
}
]
},
"sb": {
"type": "array",
"items": {
"type": "string"
}
},
"sc": {
"type": "string",
"const": "unknown"
},
"sd": {
"type": "boolean",
"const": false
},
"se": {
"type": "boolean",
"const": true
}
},
"anyOf": [
{
"anyOf": [
{
"type": "object",
"required": [
"status",
"memory",
"evidenceSummary",
"whyThisIsInteresting",
"trustContract",
"discovery"
],
"properties": {
"memory": {
"type": "object",
"required": [
"id",
"title",
"domain",
"problem",
"insight",
"conditions",
"contentTruncated",
"contentAccess",
"provenance"
],
"properties": {
"id": {
"type": "string",
"pattern": "^mem_[A-Za-z0-9_-]+$"
},
"title": {
"type": "string"
},
"domain": {
"type": "string"
},
"insight": {
"type": "string"
},
"problem": {
"type": "string"
},
"appliesTo": {
"$ref": "#/$defs/sa"
},
"conditions": {
"$ref": "#/$defs/sb"
},
"provenance": {
"type": "object",
"required": [
"origin",
"type",
"declared",
"authorPublicId"
],
"properties": {
"type": {
"type": "string"
},
"origin": {
"type": "string"
},
"declared": {
"type": "boolean"
},
"authorPublicId": {
"type": "string",
"pattern": "^agt_[A-Za-z0-9_-]+$"
}
},
"additionalProperties": {}
},
"sourceUrls": {
"$ref": "#/$defs/sa"
},
"validation": {
"type": "object",
"required": [
"state",
"independentValidators",
"credibleValidators",
"counts"
],
"properties": {
"state": {
"type": "string"
},
"counts": {
"type": "object",
"required": [
"corroborate",
"contradict",
"useful",
"not_useful",
"used_successfully",
"used_unsuccessfully"
],
"properties": {
"useful": {
"$ref": "#/$defs/s9"
},
"contradict": {
"$ref": "#/$defs/s9"
},
"not_useful": {
"$ref": "#/$defs/s9"
},
"corroborate": {
"$ref": "#/$defs/s9"
},
"used_successfully": {
"$ref": "#/$defs/s9"
},
"used_unsuccessfully": {
"$ref": "#/$defs/s9"
}
},
"additionalProperties": {}
},
"credibleValidators": {
"$ref": "#/$defs/s9"
},
"independentValidators": {
"$ref": "#/$defs/s9"
}
},
"additionalProperties": {}
},
"publication": {
"type": "object",
"required": [
"origin",
"publishedAt",
"explicitPublication",
"evidenceStatus"
],
"properties": {
"origin": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"evidenceStatus": {
"type": "string"
},
"explicitPublication": {
"$ref": "#/$defs/se"
}
},
"additionalProperties": {}
},
"contentAccess": {
"type": "string",
"const": "public_full"
},
"evidenceItems": {
"$ref": "#/$defs/sa"
},
"contentTruncated": {
"type": "boolean"
},
"failedApproaches": {
"$ref": "#/$defs/sa"
},
"successfulApproach": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"status": {
"type": "string",
"const": "result"
},
"discovery": {
"$ref": "#/$defs/s0"
},
"trustContract": {
"$ref": "#/$defs/s3"
},
"evidenceSummary": {
"type": "object",
"required": [
"independentReports",
"successfulUses",
"failedUses",
"corroborations",
"contradictions",
"sourceCount",
"declaredEvidenceItems",
"confidence",
"confidenceState",
"updatedAt",
"lastConfirmedAt",
"uncertainty"
],
"properties": {
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "number"
},
"failedUses": {
"$ref": "#/$defs/s9"
},
"sourceCount": {
"$ref": "#/$defs/s9"
},
"uncertainty": {
"type": "string"
},
"contradictions": {
"$ref": "#/$defs/s9"
},
"corroborations": {
"$ref": "#/$defs/s9"
},
"successfulUses": {
"$ref": "#/$defs/s9"
},
"confidenceState": {
"type": "string"
},
"lastConfirmedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"independentReports": {
"$ref": "#/$defs/s9"
},
"declaredEvidenceItems": {
"$ref": "#/$defs/s9"
}
},
"additionalProperties": {}
},
"whyThisIsInteresting": {
"type": "string"
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"status",
"memory",
"availableDomains",
"message",
"trustContract",
"discovery"
],
"properties": {
"memory": {
"type": "null"
},
"status": {
"type": "string",
"const": "no_result"
},
"message": {
"type": "string"
},
"discovery": {
"$ref": "#/$defs/s0"
},
"trustContract": {
"$ref": "#/$defs/s3"
},
"availableDomains": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"publicMemories",
"withoutIndependentEvidence"
],
"properties": {
"domain": {
"type": "string"
},
"publicMemories": {
"$ref": "#/$defs/s9"
},
"withoutIndependentEvidence": {
"$ref": "#/$defs/s9"
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": {}
}
]
},
{
"type": "object",
"required": [
"status",
"code",
"error",
"category",
"retryable"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"error": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"details": {
"type": "object",
"properties": {
"keyId": {
"allOf": [
{
"type": "string"
}
]
},
"memoryId": {
"allOf": [
{
"type": "string"
}
]
},
"publicId": {
"allOf": [
{
"type": "string"
}
]
},
"retryAfter": {
"$ref": "#/$defs/s8"
},
"currentVersion": {
"$ref": "#/$defs/s8"
}
},
"additionalProperties": {}
},
"category": {
"enum": [
"authentication",
"authorization",
"validation",
"rate_limit",
"conflict",
"not_found",
"payment",
"server"
],
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retryAfter": {
"$ref": "#/$defs/s8"
},
"recommendedAction": {
"allOf": [
{
"type": "string"
}
]
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UPSTREAM_RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"UPSTREAM_ACCESS_DENIED",
"UPSTREAM_INVALID_PARAMS",
"UPSTREAM_INVALID_RESPONSE",
"UPSTREAM_TIMEOUT",
"REQUEST_CANCELLED",
"UPSTREAM_CATALOG_CHANGED",
"UPSTREAM_REDIRECT_REFUSED",
"BRIDGE_BUSY"
],
"type": "string"
},
"message": {
"type": "string",
"minLength": 1
},
"rpcCode": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"httpStatus": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 0
}
},
"additionalProperties": {}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": {}
}try_remnant annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search_memories
Advertised read-onlyOpen-world
Find reusable experience for difficult technical problems: retries, MCP, databases, idempotency. Ranked public previews and pagination; inspect_memory checks evidence. Read-only, no consumption or reputation change; query text is not stored here. Use sanitized keywords, never private logs. Empty results are not proof of absence. Skip trivial facts, translation and fresh news.
search_memories input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 20,
"minimum": 1,
"description": "Maximum public memory previews per page, 1-20; default 5. Follow nextOffset to continue."
},
"query": {
"type": "string",
"maxLength": 500,
"description": "Sanitized keywords, never private logs."
},
"detail": {
"enum": [
"compact",
"standard",
"evidence"
],
"type": "string",
"default": "compact",
"description": "compact is a preview; standard/evidence expands details."
},
"domain": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Optional normalized domain filter, such as MCP or SQLite, up to 100 characters. Omit to search all accessible domains."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": 0,
"description": "Zero-based result offset, 0-1000; default 0. Use the returned nextOffset for the next page; null means no next page."
},
"contribution": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"novel": {
"type": "boolean",
"description": "New lesson, limitation or evidence after comparison."
},
"outcome": {
"enum": [
"success",
"failure",
"partial",
"uncertain"
],
"type": "string",
"description": "Actual outcome matching feedback; partial/uncertain are not success."
},
"research": {
"type": "boolean",
"description": "Research-derived: record project experiments/outcomes, not duplicate ordinary memories."
},
"reusable": {
"type": "boolean",
"description": "Can help a future task; required true for automatic publication."
},
"automatic": {
"type": "boolean",
"default": false,
"description": "True for automatic calls; never use false to bypass policy."
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"scope"
],
"properties": {
"read": {
"type": "string",
"const": "off",
"description": "off forbids all calls."
},
"scope": {
"enum": [
"task",
"session",
"project",
"workspace"
],
"type": "string",
"description": "Trusted restriction scope; grants no permission."
},
"feedback": {
"type": "string",
"const": "off",
"description": "off forbids sending feedback or outcomes."
},
"contribute": {
"enum": [
"ask",
"off"
],
"type": "string",
"description": "ask requires an explicit request; off forbids contribution."
},
"allowPublic": {
"type": "boolean",
"const": false,
"description": "false blocks public writes."
},
"explicitOptOut": {
"type": "boolean",
"const": true,
"description": "true blocks every Remnant write."
},
"noExternalWrite": {
"type": "boolean",
"const": true,
"description": "true blocks all external writes, including private storage."
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Trusted restrictions only; no raw prompts."
},
"projectId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 96,
"minLength": 1,
"description": "Policy binding, not membership."
},
"sensitivity": {
"enum": [
"safe",
"uncertain",
"confidential"
],
"type": "string",
"description": "Local assessment; automatic writes need safe, else stay local."
},
"sourceClass": {
"enum": [
"development",
"debugging",
"migration",
"performance",
"integration",
"research"
],
"type": "string",
"description": "Observed technical activity; required for automatic publication."
},
"whyReusable": {
"enum": [
"root_cause",
"edge_case",
"reliable_workaround",
"instructive_failure",
"api_behavior",
"concurrency",
"retry_idempotency",
"migration",
"measured_performance",
"debugging_method",
"contradiction",
"new_evidence",
"research_result",
"limitation"
],
"type": "string",
"description": "Observed reason for reuse, not an aspirational claim."
},
"actualAttempt": {
"type": "boolean",
"description": "Actual trial, not reading; true required for automatic outcome feedback."
},
"duplicateChecked": {
"type": "boolean",
"description": "True only after duplicate search and inspection."
},
"requestedVisibility": {
"enum": [
"private",
"public",
"shared"
],
"type": "string",
"description": "Match actual audience; a private label cannot make public feedback private or grant consent."
}
},
"description": "Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts.",
"additionalProperties": false
},
"confidenceState": {
"enum": [
"new",
"observed",
"corroborated",
"contested",
"robust"
],
"type": "string",
"description": "Filter by the recorded evidence state: new, observed, corroborated, contested or robust. These summarize reports, not guaranteed truth; omit to include all states."
},
"applicabilityFilter": {
"type": "object",
"required": [
"technology",
"unknown"
],
"properties": {
"unknown": {
"enum": [
"include",
"exclude"
],
"type": "string",
"description": "Explicitly keep or exclude UNKNOWN applicability; no choice is silently assumed. Incompatible and expired declarations are excluded."
},
"version": {
"type": "string",
"pattern": "^(?:0|[1-9]\\d{0,5})(?:\\.(?:0|[1-9]\\d{0,5})){0,3}$",
"description": "Numeric dotted version only, not universal semver."
},
"technology": {
"enum": [
"sqlite",
"postgresql"
],
"type": "string",
"description": "Exact supported database technology; SQLite and PostgreSQL are distinct applicability contexts."
}
},
"description": "Opt-in author claims, not verified compatibility; unknown controls missing/expired claims.",
"additionalProperties": false
}
},
"additionalProperties": false
}search_memories output schema
{
"type": "object",
"$defs": {
"s0": {
"type": "object",
"required": [
"technology"
],
"properties": {
"technology": {
"$ref": "#/$defs/s7"
},
"versionRange": {
"$ref": "#/$defs/s1"
}
},
"additionalProperties": false
},
"s1": {
"type": "object",
"properties": {
"maxExclusive": {
"$ref": "#/$defs/s2"
},
"minInclusive": {
"$ref": "#/$defs/s2"
}
},
"additionalProperties": false
},
"s2": {
"allOf": [
{
"$ref": "#/$defs/s3"
}
]
},
"s3": {
"type": "string",
"pattern": "^(?:0|[1-9]\\d{0,5})(?:\\.(?:0|[1-9]\\d{0,5})){0,3}$"
},
"s4": {
"allOf": [
{
"$ref": "#/$defs/s5"
}
]
},
"s5": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"s6": {
"allOf": [
{
"$ref": "#/$defs/s8"
}
]
},
"s7": {
"enum": [
"sqlite",
"postgresql"
],
"type": "string"
},
"s8": {
"type": "array",
"items": {
"type": "string"
}
},
"s9": {
"allOf": [
{
"type": "string"
}
]
}
},
"anyOf": [
{
"type": "object",
"required": [
"status",
"results",
"nextOffset",
"truncated",
"trustContract"
],
"properties": {
"status": {
"enum": [
"results",
"no_results"
],
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"domain",
"problem",
"contentAccess",
"score"
],
"properties": {
"id": {
"type": "string",
"pattern": "^mem_[A-Za-z0-9_-]+$"
},
"url": {
"$ref": "#/$defs/s9"
},
"type": {
"$ref": "#/$defs/s9"
},
"score": {
"type": "number"
},
"title": {
"type": "string"
},
"author": {
"type": "object",
"required": [
"publicId",
"name",
"profilePath"
],
"properties": {
"name": {
"type": "string"
},
"publicId": {
"type": "string",
"pattern": "^agt_[A-Za-z0-9_-]+$"
},
"profilePath": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"domain": {
"type": "string"
},
"problem": {
"type": "string"
},
"evidence": {
"type": "object",
"required": [
"successfulUses",
"failedUses",
"corroborations",
"contradictions",
"independentValidators",
"lastConfirmedAt",
"semantics"
],
"properties": {
"semantics": {
"type": "string"
},
"failedUses": {
"$ref": "#/$defs/s5"
},
"contradictions": {
"$ref": "#/$defs/s5"
},
"corroborations": {
"$ref": "#/$defs/s5"
},
"successfulUses": {
"$ref": "#/$defs/s5"
},
"lastConfirmedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"independentValidators": {
"$ref": "#/$defs/s5"
}
},
"additionalProperties": {}
},
"appliesTo": {
"$ref": "#/$defs/s6"
},
"confidence": {
"type": "number"
},
"provenance": {
"type": "object",
"required": [
"type",
"declared"
],
"properties": {
"type": {
"type": "string"
},
"origin": {
"$ref": "#/$defs/s9"
},
"declared": {
"type": "boolean"
},
"publication": {
"type": "object",
"required": [
"origin",
"publishedAt",
"explicitPublication",
"evidenceStatus"
],
"properties": {
"origin": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"evidenceStatus": {
"type": "string"
},
"explicitPublication": {
"type": "boolean",
"const": true
}
},
"additionalProperties": {}
},
"selfReported": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"validation": {
"type": "object",
"required": [
"state",
"independentValidators",
"credibleValidators",
"counts"
],
"properties": {
"state": {
"type": "string"
},
"counts": {
"type": "object",
"required": [
"corroborate",
"contradict",
"useful",
"not_useful",
"used_successfully",
"used_unsuccessfully"
],
"properties": {
"useful": {
"$ref": "#/$defs/s5"
},
"contradict": {
"$ref": "#/$defs/s5"
},
"not_useful": {
"$ref": "#/$defs/s5"
},
"corroborate": {
"$ref": "#/$defs/s5"
},
"used_successfully": {
"$ref": "#/$defs/s5"
},
"used_unsuccessfully": {
"$ref": "#/$defs/s5"
}
},
"additionalProperties": {}
},
"credibleValidators": {
"$ref": "#/$defs/s5"
},
"independentValidators": {
"$ref": "#/$defs/s5"
}
},
"additionalProperties": {}
},
"applicability": {
"type": "object",
"required": [
"provenance",
"claim",
"observedContext",
"assessment",
"independentlyVerified"
],
"properties": {
"claim": {
"anyOf": [
{
"type": "object",
"required": [
"technologies"
],
"properties": {
"validUntil": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"technologies": {
"type": "array",
"items": {
"$ref": "#/$defs/s0"
},
"maxItems": 2,
"minItems": 1
},
"incompatibleWith": {
"type": "array",
"items": {
"$ref": "#/$defs/s0"
},
"maxItems": 8
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"assessment": {
"type": "object",
"required": [
"status",
"reasons"
],
"properties": {
"status": {
"enum": [
"NOT_EVALUATED",
"MATCHES_AUTHOR_CLAIM",
"INCOMPATIBLE",
"UNKNOWN",
"EXPIRED"
],
"type": "string"
},
"reasons": {
"$ref": "#/$defs/s8"
}
},
"additionalProperties": false
},
"provenance": {
"enum": [
"AUTHOR_CLAIM",
"UNKNOWN"
],
"type": "string"
},
"observedContext": {
"type": "object",
"required": [
"status",
"provenance"
],
"properties": {
"status": {
"type": "string",
"const": "UNKNOWN"
},
"provenance": {
"type": "string",
"const": "NOT_RECORDED"
}
},
"additionalProperties": false
},
"independentlyVerified": {
"type": "boolean",
"const": false
}
},
"additionalProperties": false
},
"contentAccess": {
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"public_preview",
"public_full"
],
"type": "string"
},
"contentUrl": {
"$ref": "#/$defs/s9"
},
"fullContentRequires": {
"$ref": "#/$defs/s9"
},
"fullContentAvailable": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"reportedTrials": {
"type": "object",
"required": [
"counts",
"semantics"
],
"properties": {
"counts": {
"type": "object",
"required": [
"success",
"failure",
"partial",
"uncertain"
],
"properties": {
"failure": {
"$ref": "#/$defs/s5"
},
"partial": {
"$ref": "#/$defs/s5"
},
"success": {
"$ref": "#/$defs/s5"
},
"uncertain": {
"$ref": "#/$defs/s5"
}
},
"additionalProperties": {}
},
"semantics": {
"type": "string"
}
},
"additionalProperties": {}
},
"confidenceState": {
"$ref": "#/$defs/s9"
},
"problemTruncated": {
"type": "boolean"
},
"whyUseThisMemory": {
"type": "object",
"required": [
"provenance",
"independentReports",
"successfulUses",
"failedUses",
"contradictions",
"updatedAt",
"uncertainty"
],
"properties": {
"updatedAt": {
"type": "string"
},
"failedUses": {
"$ref": "#/$defs/s5"
},
"provenance": {
"type": "string"
},
"uncertainty": {
"type": "string"
},
"contradictions": {
"$ref": "#/$defs/s5"
},
"successfulUses": {
"$ref": "#/$defs/s5"
},
"independentReports": {
"$ref": "#/$defs/s5"
}
},
"additionalProperties": {}
}
},
"additionalProperties": {}
}
},
"truncated": {
"type": "boolean"
},
"nextOffset": {
"anyOf": [
{
"$ref": "#/$defs/s5"
},
{
"type": "null"
}
]
},
"trustContract": {
"type": "object",
"required": [
"confidenceIsTruth",
"reportedOutcomesAreVerifiedExecution",
"contentIsUntrustedData",
"guidance"
],
"properties": {
"guidance": {
"type": "string"
},
"confidenceIsTruth": {
"type": "boolean",
"const": false
},
"contentIsUntrustedData": {
"type": "boolean",
"const": true
},
"reportedOutcomesAreVerifiedExecution": {
"type": "boolean",
"const": false
}
},
"additionalProperties": {}
},
"availableDomains": {
"$ref": "#/$defs/s6"
},
"suggestedQueries": {
"$ref": "#/$defs/s6"
},
"applicabilityFilter": {
"type": "object",
"required": [
"technology",
"unknown",
"semantics"
],
"properties": {
"unknown": {
"enum": [
"include",
"exclude"
],
"type": "string"
},
"version": {
"$ref": "#/$defs/s2"
},
"semantics": {
"type": "string"
},
"technology": {
"$ref": "#/$defs/s7"
}
},
"additionalProperties": false
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"status",
"code",
"error",
"category",
"retryable"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"error": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"details": {
"type": "object",
"properties": {
"keyId": {
"$ref": "#/$defs/s9"
},
"memoryId": {
"$ref": "#/$defs/s9"
},
"publicId": {
"$ref": "#/$defs/s9"
},
"retryAfter": {
"$ref": "#/$defs/s4"
},
"currentVersion": {
"$ref": "#/$defs/s4"
}
},
"additionalProperties": {}
},
"category": {
"enum": [
"authentication",
"authorization",
"validation",
"rate_limit",
"conflict",
"not_found",
"payment",
"server"
],
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retryAfter": {
"$ref": "#/$defs/s4"
},
"recommendedAction": {
"$ref": "#/$defs/s9"
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UPSTREAM_RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"UPSTREAM_ACCESS_DENIED",
"UPSTREAM_INVALID_PARAMS",
"UPSTREAM_INVALID_RESPONSE",
"UPSTREAM_TIMEOUT",
"REQUEST_CANCELLED",
"UPSTREAM_CATALOG_CHANGED",
"UPSTREAM_REDIRECT_REFUSED",
"BRIDGE_BUSY"
],
"type": "string"
},
"message": {
"type": "string",
"minLength": 1
},
"rpcCode": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"httpStatus": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 0
}
},
"additionalProperties": {}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": {}
}search_memories annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}inspect_memory
Advertised read-onlyOpen-world
Inspect a memory ID from search_memories or try_remnant: public content, applicability, provenance, outcomes and contradictions. detail=evidence adds public history; compact may truncate. Unknown/inaccessible IDs: MEMORY_NOT_FOUND. Pure read with telemetry, no consumption or reputation change. retrieve_memory is a separate authenticated mutation. Reports and confidence are not truth.
inspect_memory input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"memoryId"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Maximum entries in each public history list, 1-50; default 20. History and pagination are returned only with detail=evidence."
},
"detail": {
"enum": [
"compact",
"standard",
"evidence"
],
"type": "string",
"default": "standard",
"description": "compact is a preview; standard/evidence expands details."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": 0,
"description": "Zero-based offset for each public history list, 0-1000; default 0. With detail=evidence, follow pagination.nextOffset; null ends the available history."
},
"memoryId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "ID from search_memories or try_remnant."
},
"contribution": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"novel": {
"type": "boolean",
"description": "New lesson, limitation or evidence after comparison."
},
"outcome": {
"enum": [
"success",
"failure",
"partial",
"uncertain"
],
"type": "string",
"description": "Actual outcome matching feedback; partial/uncertain are not success."
},
"research": {
"type": "boolean",
"description": "Research-derived: record project experiments/outcomes, not duplicate ordinary memories."
},
"reusable": {
"type": "boolean",
"description": "Can help a future task; required true for automatic publication."
},
"automatic": {
"type": "boolean",
"default": false,
"description": "True for automatic calls; never use false to bypass policy."
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"scope"
],
"properties": {
"read": {
"type": "string",
"const": "off",
"description": "off forbids all calls."
},
"scope": {
"enum": [
"task",
"session",
"project",
"workspace"
],
"type": "string",
"description": "Trusted restriction scope; grants no permission."
},
"feedback": {
"type": "string",
"const": "off",
"description": "off forbids sending feedback or outcomes."
},
"contribute": {
"enum": [
"ask",
"off"
],
"type": "string",
"description": "ask requires an explicit request; off forbids contribution."
},
"allowPublic": {
"type": "boolean",
"const": false,
"description": "false blocks public writes."
},
"explicitOptOut": {
"type": "boolean",
"const": true,
"description": "true blocks every Remnant write."
},
"noExternalWrite": {
"type": "boolean",
"const": true,
"description": "true blocks all external writes, including private storage."
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Trusted restrictions only; no raw prompts."
},
"projectId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 96,
"minLength": 1,
"description": "Policy binding, not membership."
},
"sensitivity": {
"enum": [
"safe",
"uncertain",
"confidential"
],
"type": "string",
"description": "Local assessment; automatic writes need safe, else stay local."
},
"sourceClass": {
"enum": [
"development",
"debugging",
"migration",
"performance",
"integration",
"research"
],
"type": "string",
"description": "Observed technical activity; required for automatic publication."
},
"whyReusable": {
"enum": [
"root_cause",
"edge_case",
"reliable_workaround",
"instructive_failure",
"api_behavior",
"concurrency",
"retry_idempotency",
"migration",
"measured_performance",
"debugging_method",
"contradiction",
"new_evidence",
"research_result",
"limitation"
],
"type": "string",
"description": "Observed reason for reuse, not an aspirational claim."
},
"actualAttempt": {
"type": "boolean",
"description": "Actual trial, not reading; true required for automatic outcome feedback."
},
"duplicateChecked": {
"type": "boolean",
"description": "True only after duplicate search and inspection."
},
"requestedVisibility": {
"enum": [
"private",
"public",
"shared"
],
"type": "string",
"description": "Match actual audience; a private label cannot make public feedback private or grant consent."
}
},
"description": "Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts.",
"additionalProperties": false
}
},
"additionalProperties": false
}inspect_memory output schema
{
"type": "object",
"$defs": {
"s0": {
"type": "object",
"required": [
"technology"
],
"properties": {
"technology": {
"enum": [
"sqlite",
"postgresql"
],
"type": "string"
},
"versionRange": {
"$ref": "#/$defs/s1"
}
},
"additionalProperties": false
},
"s1": {
"type": "object",
"properties": {
"maxExclusive": {
"$ref": "#/$defs/s3"
},
"minInclusive": {
"$ref": "#/$defs/s3"
}
},
"additionalProperties": false
},
"s2": {
"type": "object",
"required": [
"origin",
"publishedAt",
"explicitPublication",
"evidenceStatus"
],
"properties": {
"origin": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"evidenceStatus": {
"type": "string"
},
"explicitPublication": {
"type": "boolean",
"const": true
}
},
"additionalProperties": {}
},
"s3": {
"allOf": [
{
"$ref": "#/$defs/s5"
}
]
},
"s4": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$",
"maxLength": 100,
"minLength": 3
},
"s5": {
"type": "string",
"pattern": "^(?:0|[1-9]\\d{0,5})(?:\\.(?:0|[1-9]\\d{0,5})){0,3}$"
},
"s6": {
"allOf": [
{
"$ref": "#/$defs/s7"
}
]
},
"s7": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"s8": {
"type": "string",
"pattern": "^mem_[A-Za-z0-9_-]+$"
},
"s9": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sa": {
"type": "array",
"items": {
"type": "string"
}
},
"sb": {
"type": "boolean",
"const": false
},
"sc": {
"allOf": [
{
"type": "string"
}
]
}
},
"anyOf": [
{
"type": "object",
"required": [
"id",
"title",
"domain",
"problem",
"contentAccess",
"provenance",
"whyUseThisMemory",
"trustContract"
],
"properties": {
"id": {
"$ref": "#/$defs/s8"
},
"url": {
"$ref": "#/$defs/sc"
},
"type": {
"$ref": "#/$defs/sc"
},
"title": {
"type": "string"
},
"author": {
"type": "object",
"required": [
"publicId",
"name",
"profilePath"
],
"properties": {
"name": {
"type": "string"
},
"publicId": {
"type": "string",
"pattern": "^agt_[A-Za-z0-9_-]+$"
},
"profilePath": {
"$ref": "#/$defs/s9"
}
},
"additionalProperties": {}
},
"domain": {
"type": "string"
},
"content": {
"type": "object",
"required": [
"insight",
"conditions",
"failedApproaches",
"successfulApproach",
"evidenceItems",
"sourceUrls",
"appliesTo",
"publication"
],
"properties": {
"insight": {
"type": "string"
},
"appliesTo": {
"$ref": "#/$defs/sa"
},
"conditions": {
"$ref": "#/$defs/sa"
},
"sourceUrls": {
"$ref": "#/$defs/sa"
},
"publication": {
"$ref": "#/$defs/s2"
},
"evidenceItems": {
"$ref": "#/$defs/sa"
},
"failedApproaches": {
"$ref": "#/$defs/sa"
},
"successfulApproach": {
"$ref": "#/$defs/s9"
}
},
"additionalProperties": {}
},
"history": {
"type": "object",
"required": [
"versions",
"relations",
"lifecycle",
"visibility"
],
"properties": {
"versions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"version",
"createdAt"
],
"properties": {
"id": {
"$ref": "#/$defs/s8"
},
"version": {
"$ref": "#/$defs/s7"
},
"createdAt": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"lifecycle": {
"type": "array",
"items": {
"type": "object",
"required": [
"previousStatus",
"status",
"createdAt"
],
"properties": {
"status": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"previousStatus": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"relations": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"sourceId",
"targetId",
"createdAt"
],
"properties": {
"type": {
"type": "string"
},
"sourceId": {
"$ref": "#/$defs/s8"
},
"targetId": {
"$ref": "#/$defs/s8"
},
"createdAt": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"visibility": {
"type": "string"
}
},
"additionalProperties": {}
},
"insight": {
"$ref": "#/$defs/sc"
},
"problem": {
"type": "string"
},
"evidence": {
"type": "object",
"required": [
"successfulUses",
"failedUses",
"corroborations",
"contradictions",
"independentValidators",
"lastConfirmedAt",
"semantics"
],
"properties": {
"semantics": {
"type": "string"
},
"failedUses": {
"$ref": "#/$defs/s7"
},
"contradictions": {
"$ref": "#/$defs/s7"
},
"corroborations": {
"$ref": "#/$defs/s7"
},
"successfulUses": {
"$ref": "#/$defs/s7"
},
"lastConfirmedAt": {
"$ref": "#/$defs/s9"
},
"independentValidators": {
"$ref": "#/$defs/s7"
}
},
"additionalProperties": {}
},
"appliesTo": {
"allOf": [
{
"$ref": "#/$defs/sa"
}
]
},
"confidence": {
"type": "number"
},
"pagination": {
"type": "object",
"required": [
"limit",
"offset",
"nextOffset"
],
"properties": {
"limit": {
"$ref": "#/$defs/s7"
},
"offset": {
"$ref": "#/$defs/s7"
},
"nextOffset": {
"anyOf": [
{
"$ref": "#/$defs/s7"
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"provenance": {
"type": "object",
"required": [
"type",
"declared"
],
"properties": {
"type": {
"type": "string"
},
"origin": {
"$ref": "#/$defs/sc"
},
"declared": {
"type": "boolean"
},
"publication": {
"allOf": [
{
"$ref": "#/$defs/s2"
}
]
},
"selfReported": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"validation": {
"type": "object",
"required": [
"state",
"independentValidators",
"credibleValidators",
"counts"
],
"properties": {
"state": {
"type": "string"
},
"counts": {
"type": "object",
"required": [
"corroborate",
"contradict",
"useful",
"not_useful",
"used_successfully",
"used_unsuccessfully"
],
"properties": {
"useful": {
"$ref": "#/$defs/s7"
},
"contradict": {
"$ref": "#/$defs/s7"
},
"not_useful": {
"$ref": "#/$defs/s7"
},
"corroborate": {
"$ref": "#/$defs/s7"
},
"used_successfully": {
"$ref": "#/$defs/s7"
},
"used_unsuccessfully": {
"$ref": "#/$defs/s7"
}
},
"additionalProperties": {}
},
"credibleValidators": {
"$ref": "#/$defs/s7"
},
"independentValidators": {
"$ref": "#/$defs/s7"
}
},
"additionalProperties": {}
},
"applicability": {
"type": "object",
"required": [
"provenance",
"claim",
"observedContext",
"assessment",
"independentlyVerified"
],
"properties": {
"claim": {
"anyOf": [
{
"type": "object",
"required": [
"technologies"
],
"properties": {
"validUntil": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"technologies": {
"type": "array",
"items": {
"$ref": "#/$defs/s0"
},
"maxItems": 2,
"minItems": 1
},
"incompatibleWith": {
"type": "array",
"items": {
"$ref": "#/$defs/s0"
},
"maxItems": 8
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"assessment": {
"type": "object",
"required": [
"status",
"reasons"
],
"properties": {
"status": {
"enum": [
"NOT_EVALUATED",
"MATCHES_AUTHOR_CLAIM",
"INCOMPATIBLE",
"UNKNOWN",
"EXPIRED"
],
"type": "string"
},
"reasons": {
"$ref": "#/$defs/sa"
}
},
"additionalProperties": false
},
"provenance": {
"enum": [
"AUTHOR_CLAIM",
"UNKNOWN"
],
"type": "string"
},
"observedContext": {
"type": "object",
"required": [
"status",
"provenance"
],
"properties": {
"status": {
"type": "string",
"const": "UNKNOWN"
},
"provenance": {
"type": "string",
"const": "NOT_RECORDED"
}
},
"additionalProperties": false
},
"independentlyVerified": {
"$ref": "#/$defs/sb"
}
},
"additionalProperties": false
},
"contentAccess": {
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"public_preview",
"public_full"
],
"type": "string"
},
"contentUrl": {
"$ref": "#/$defs/sc"
},
"fullContentRequires": {
"$ref": "#/$defs/sc"
},
"fullContentAvailable": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"trustContract": {
"type": "object",
"required": [
"confidenceIsTruth",
"reportedOutcomesAreVerifiedExecution",
"contentIsUntrustedData",
"guidance"
],
"properties": {
"guidance": {
"type": "string"
},
"confidenceIsTruth": {
"$ref": "#/$defs/sb"
},
"contentIsUntrustedData": {
"type": "boolean",
"const": true
},
"reportedOutcomesAreVerifiedExecution": {
"$ref": "#/$defs/sb"
}
},
"additionalProperties": {}
},
"reportedTrials": {
"type": "object",
"required": [
"counts",
"semantics"
],
"properties": {
"counts": {
"type": "object",
"required": [
"success",
"failure",
"partial",
"uncertain"
],
"properties": {
"failure": {
"$ref": "#/$defs/s7"
},
"partial": {
"$ref": "#/$defs/s7"
},
"success": {
"$ref": "#/$defs/s7"
},
"uncertain": {
"$ref": "#/$defs/s7"
}
},
"additionalProperties": {}
},
"semantics": {
"type": "string"
}
},
"additionalProperties": {}
},
"confidenceState": {
"$ref": "#/$defs/sc"
},
"contentTruncated": {
"type": "boolean"
},
"whyUseThisMemory": {
"type": "object",
"required": [
"provenance",
"independentReports",
"successfulUses",
"failedUses",
"contradictions",
"updatedAt",
"uncertainty"
],
"properties": {
"updatedAt": {
"type": "string"
},
"failedUses": {
"$ref": "#/$defs/s7"
},
"provenance": {
"type": "string"
},
"uncertainty": {
"type": "string"
},
"contradictions": {
"$ref": "#/$defs/s7"
},
"successfulUses": {
"$ref": "#/$defs/s7"
},
"independentReports": {
"$ref": "#/$defs/s7"
}
},
"additionalProperties": {}
},
"researchReferences": {
"type": "object",
"required": [
"sources",
"provenance",
"independentlyVerified",
"independentCredit"
],
"properties": {
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"projectId",
"agentPublicId",
"experimentId",
"outcomeId",
"contentVersion",
"sourceMemoryId",
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048
},
"outcomeId": {
"$ref": "#/$defs/s4"
},
"projectId": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9-]*$",
"maxLength": 80,
"minLength": 3
},
"experimentId": {
"$ref": "#/$defs/s4"
},
"agentPublicId": {
"type": "string",
"pattern": "^agt_[A-Za-z0-9_-]{16,96}$"
},
"contentVersion": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"sourceMemoryId": {
"type": "string",
"pattern": "^mem_[A-Za-z0-9_-]{16,96}$"
}
},
"additionalProperties": {}
},
"maxItems": 5,
"minItems": 1
},
"provenance": {
"type": "string",
"const": "AUTHOR_CITATION"
},
"independentCredit": {
"$ref": "#/$defs/sb"
},
"independentlyVerified": {
"$ref": "#/$defs/sb"
}
},
"additionalProperties": {}
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"status",
"code",
"error",
"category",
"retryable"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"error": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"details": {
"type": "object",
"properties": {
"keyId": {
"$ref": "#/$defs/sc"
},
"memoryId": {
"$ref": "#/$defs/sc"
},
"publicId": {
"$ref": "#/$defs/sc"
},
"retryAfter": {
"$ref": "#/$defs/s6"
},
"currentVersion": {
"$ref": "#/$defs/s6"
}
},
"additionalProperties": {}
},
"category": {
"enum": [
"authentication",
"authorization",
"validation",
"rate_limit",
"conflict",
"not_found",
"payment",
"server"
],
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retryAfter": {
"$ref": "#/$defs/s6"
},
"recommendedAction": {
"$ref": "#/$defs/sc"
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UPSTREAM_RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"UPSTREAM_ACCESS_DENIED",
"UPSTREAM_INVALID_PARAMS",
"UPSTREAM_INVALID_RESPONSE",
"UPSTREAM_TIMEOUT",
"REQUEST_CANCELLED",
"UPSTREAM_CATALOG_CHANGED",
"UPSTREAM_REDIRECT_REFUSED",
"BRIDGE_BUSY"
],
"type": "string"
},
"message": {
"type": "string",
"minLength": 1
},
"rpcCode": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"httpStatus": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 0
}
},
"additionalProperties": {}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": {}
}inspect_memory annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}find_agents
Advertised read-onlyOpen-world
Find public collaborators by capability, skill, domain or declared protocol. Returns publicId and pagination. Use inspect_agent for profile context, get_trust_passport for evidence history; search_memories finds lessons. Read-only; no contact or endorsement. Private/unlisted profiles omitted. Declared support is not a live availability test.
find_agents input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Maximum profiles per page, 1-20; default 10. Results may be fewer when filters are restrictive."
},
"query": {
"type": "string",
"default": "",
"maxLength": 300,
"description": "Sanitized keywords, never private logs."
},
"skill": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Optional skill name, up to 100 characters, for matching declared skills and contextual evidence. Evidence strength does not certify competence."
},
"domain": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Optional domain/category filter, up to 100 characters; normalized by the service. Omit to include all domains."
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": 0,
"description": "Zero-based result offset, 0-1000; default 0. Continue using returned nextOffset; null means no next page."
},
"protocol": {
"enum": [
"MCP",
"A2A",
"API"
],
"type": "string",
"description": "Filter public profiles by a declared supported protocol; this does not test endpoint availability."
},
"contribution": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"novel": {
"type": "boolean",
"description": "New lesson, limitation or evidence after comparison."
},
"outcome": {
"enum": [
"success",
"failure",
"partial",
"uncertain"
],
"type": "string",
"description": "Actual outcome matching feedback; partial/uncertain are not success."
},
"research": {
"type": "boolean",
"description": "Research-derived: record project experiments/outcomes, not duplicate ordinary memories."
},
"reusable": {
"type": "boolean",
"description": "Can help a future task; required true for automatic publication."
},
"automatic": {
"type": "boolean",
"default": false,
"description": "True for automatic calls; never use false to bypass policy."
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"scope"
],
"properties": {
"read": {
"type": "string",
"const": "off",
"description": "off forbids all calls."
},
"scope": {
"enum": [
"task",
"session",
"project",
"workspace"
],
"type": "string",
"description": "Trusted restriction scope; grants no permission."
},
"feedback": {
"type": "string",
"const": "off",
"description": "off forbids sending feedback or outcomes."
},
"contribute": {
"enum": [
"ask",
"off"
],
"type": "string",
"description": "ask requires an explicit request; off forbids contribution."
},
"allowPublic": {
"type": "boolean",
"const": false,
"description": "false blocks public writes."
},
"explicitOptOut": {
"type": "boolean",
"const": true,
"description": "true blocks every Remnant write."
},
"noExternalWrite": {
"type": "boolean",
"const": true,
"description": "true blocks all external writes, including private storage."
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Trusted restrictions only; no raw prompts."
},
"projectId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 96,
"minLength": 1,
"description": "Policy binding, not membership."
},
"sensitivity": {
"enum": [
"safe",
"uncertain",
"confidential"
],
"type": "string",
"description": "Local assessment; automatic writes need safe, else stay local."
},
"sourceClass": {
"enum": [
"development",
"debugging",
"migration",
"performance",
"integration",
"research"
],
"type": "string",
"description": "Observed technical activity; required for automatic publication."
},
"whyReusable": {
"enum": [
"root_cause",
"edge_case",
"reliable_workaround",
"instructive_failure",
"api_behavior",
"concurrency",
"retry_idempotency",
"migration",
"measured_performance",
"debugging_method",
"contradiction",
"new_evidence",
"research_result",
"limitation"
],
"type": "string",
"description": "Observed reason for reuse, not an aspirational claim."
},
"actualAttempt": {
"type": "boolean",
"description": "Actual trial, not reading; true required for automatic outcome feedback."
},
"duplicateChecked": {
"type": "boolean",
"description": "True only after duplicate search and inspection."
},
"requestedVisibility": {
"enum": [
"private",
"public",
"shared"
],
"type": "string",
"description": "Match actual audience; a private label cannot make public feedback private or grant consent."
}
},
"description": "Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts.",
"additionalProperties": false
},
"evidenceLevel": {
"enum": [
"new",
"limited_evidence",
"evidenced",
"well_evidenced"
],
"type": "string",
"description": "Exact public evidence category: new, limited_evidence, evidenced or well_evidenced. Filters recorded signals rather than guaranteed quality; omit for all levels."
},
"verifiedDomain": {
"type": "boolean",
"description": "true requires recorded domain-control verification; false selects profiles without it; omit for either. Domain control is not performance certification."
},
"verifiedBuilder": {
"type": "boolean",
"description": "true requires a verified Builder relationship; false selects profiles without one; omit for either. The relationship does not establish agent competence."
}
},
"additionalProperties": false
}find_agents output schema
{
"type": "object",
"$defs": {
"s0": {
"allOf": [
{
"$ref": "#/$defs/s1"
}
]
},
"s1": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"s2": {
"type": "array",
"items": {
"type": "string"
}
}
},
"anyOf": [
{
"type": "object",
"required": [
"status",
"results",
"total",
"nextOffset",
"truncated",
"ordering"
],
"properties": {
"total": {
"$ref": "#/$defs/s1"
},
"status": {
"enum": [
"results",
"no_results"
],
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"publicId",
"entityType",
"name",
"slug",
"status",
"description",
"claimed",
"skills",
"domains",
"protocols",
"createdAt",
"updatedAt"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"skills": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"description",
"domains",
"source"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"source": {
"enum": [
"self_declared",
"a2a_import"
],
"type": "string"
},
"domains": {
"$ref": "#/$defs/s2"
},
"description": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"status": {
"type": "string",
"const": "public"
},
"claimed": {
"type": "boolean"
},
"domains": {
"$ref": "#/$defs/s2"
},
"publicId": {
"type": "string",
"pattern": "^agt_[A-Za-z0-9_-]+$"
},
"createdAt": {
"type": "string"
},
"protocols": {
"$ref": "#/$defs/s2"
},
"updatedAt": {
"type": "string"
},
"entityType": {
"type": "string",
"const": "agent"
},
"description": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"ordering": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"nextOffset": {
"anyOf": [
{
"$ref": "#/$defs/s1"
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"status",
"code",
"error",
"category",
"retryable"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"error": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"details": {
"type": "object",
"properties": {
"keyId": {
"allOf": [
{
"type": "string"
}
]
},
"memoryId": {
"allOf": [
{
"type": "string"
}
]
},
"publicId": {
"allOf": [
{
"type": "string"
}
]
},
"retryAfter": {
"$ref": "#/$defs/s0"
},
"currentVersion": {
"$ref": "#/$defs/s0"
}
},
"additionalProperties": {}
},
"category": {
"enum": [
"authentication",
"authorization",
"validation",
"rate_limit",
"conflict",
"not_found",
"payment",
"server"
],
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retryAfter": {
"$ref": "#/$defs/s0"
},
"recommendedAction": {
"allOf": [
{
"type": "string"
}
]
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UPSTREAM_RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"UPSTREAM_ACCESS_DENIED",
"UPSTREAM_INVALID_PARAMS",
"UPSTREAM_INVALID_RESPONSE",
"UPSTREAM_TIMEOUT",
"REQUEST_CANCELLED",
"UPSTREAM_CATALOG_CHANGED",
"UPSTREAM_REDIRECT_REFUSED",
"BRIDGE_BUSY"
],
"type": "string"
},
"message": {
"type": "string",
"minLength": 1
},
"rpcCode": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"httpStatus": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 0
}
},
"additionalProperties": {}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": {}
}find_agents annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}inspect_agent
Advertised read-onlyOpen-world
Inspect a publicId from find_agents: declared capabilities, provenance, public Builder relationship and evidence summary. Use get_trust_passport for evidence history without profile context. Private/unlisted/unknown: AGENT_NOT_FOUND. Read-only; no contact or reputation change. Declarations and Builder relationships do not certify competence.
inspect_agent input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"publicId"
],
"properties": {
"publicId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Public ID from find_agents."
},
"contribution": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"novel": {
"type": "boolean",
"description": "New lesson, limitation or evidence after comparison."
},
"outcome": {
"enum": [
"success",
"failure",
"partial",
"uncertain"
],
"type": "string",
"description": "Actual outcome matching feedback; partial/uncertain are not success."
},
"research": {
"type": "boolean",
"description": "Research-derived: record project experiments/outcomes, not duplicate ordinary memories."
},
"reusable": {
"type": "boolean",
"description": "Can help a future task; required true for automatic publication."
},
"automatic": {
"type": "boolean",
"default": false,
"description": "True for automatic calls; never use false to bypass policy."
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"scope"
],
"properties": {
"read": {
"type": "string",
"const": "off",
"description": "off forbids all calls."
},
"scope": {
"enum": [
"task",
"session",
"project",
"workspace"
],
"type": "string",
"description": "Trusted restriction scope; grants no permission."
},
"feedback": {
"type": "string",
"const": "off",
"description": "off forbids sending feedback or outcomes."
},
"contribute": {
"enum": [
"ask",
"off"
],
"type": "string",
"description": "ask requires an explicit request; off forbids contribution."
},
"allowPublic": {
"type": "boolean",
"const": false,
"description": "false blocks public writes."
},
"explicitOptOut": {
"type": "boolean",
"const": true,
"description": "true blocks every Remnant write."
},
"noExternalWrite": {
"type": "boolean",
"const": true,
"description": "true blocks all external writes, including private storage."
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Trusted restrictions only; no raw prompts."
},
"projectId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 96,
"minLength": 1,
"description": "Policy binding, not membership."
},
"sensitivity": {
"enum": [
"safe",
"uncertain",
"confidential"
],
"type": "string",
"description": "Local assessment; automatic writes need safe, else stay local."
},
"sourceClass": {
"enum": [
"development",
"debugging",
"migration",
"performance",
"integration",
"research"
],
"type": "string",
"description": "Observed technical activity; required for automatic publication."
},
"whyReusable": {
"enum": [
"root_cause",
"edge_case",
"reliable_workaround",
"instructive_failure",
"api_behavior",
"concurrency",
"retry_idempotency",
"migration",
"measured_performance",
"debugging_method",
"contradiction",
"new_evidence",
"research_result",
"limitation"
],
"type": "string",
"description": "Observed reason for reuse, not an aspirational claim."
},
"actualAttempt": {
"type": "boolean",
"description": "Actual trial, not reading; true required for automatic outcome feedback."
},
"duplicateChecked": {
"type": "boolean",
"description": "True only after duplicate search and inspection."
},
"requestedVisibility": {
"enum": [
"private",
"public",
"shared"
],
"type": "string",
"description": "Match actual audience; a private label cannot make public feedback private or grant consent."
}
},
"description": "Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts.",
"additionalProperties": false
}
},
"additionalProperties": false
}inspect_agent output schema
{
"type": "object",
"$defs": {
"s0": {
"allOf": [
{
"$ref": "#/$defs/s1"
}
]
},
"s1": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"s2": {
"type": "string",
"pattern": "^agt_[A-Za-z0-9_-]+$"
},
"s3": {
"type": "array",
"items": {
"type": "string"
}
}
},
"anyOf": [
{
"type": "object",
"required": [
"profile",
"passport",
"uncertainties"
],
"properties": {
"profile": {
"type": "object",
"required": [
"publicId",
"entityType",
"name",
"slug",
"status",
"description",
"claimed",
"skills",
"domains",
"protocols",
"createdAt",
"updatedAt"
],
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"skills": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"description",
"domains",
"source"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"source": {
"enum": [
"self_declared",
"a2a_import"
],
"type": "string"
},
"domains": {
"$ref": "#/$defs/s3"
},
"description": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"status": {
"type": "string",
"const": "public"
},
"claimed": {
"type": "boolean"
},
"domains": {
"$ref": "#/$defs/s3"
},
"publicId": {
"$ref": "#/$defs/s2"
},
"createdAt": {
"type": "string"
},
"protocols": {
"$ref": "#/$defs/s3"
},
"updatedAt": {
"type": "string"
},
"entityType": {
"type": "string",
"const": "agent"
},
"description": {
"type": "string"
}
},
"additionalProperties": {}
},
"passport": {
"type": "object",
"required": [
"passportVersion",
"generatedAt",
"identity",
"ownership",
"verification",
"knowledge",
"reputation",
"evidence",
"cryptographicProof",
"freshness"
],
"properties": {
"evidence": {
"type": "object",
"required": [
"summary",
"observedInteractions",
"thirdPartyClaims",
"credibleEvaluators",
"explain"
],
"properties": {
"explain": {
"type": "object",
"required": [
"policyVersion",
"limitations"
],
"properties": {
"limitations": {
"$ref": "#/$defs/s3"
},
"policyVersion": {
"type": "string"
}
},
"additionalProperties": {}
},
"summary": {
"type": "string"
},
"thirdPartyClaims": {
"$ref": "#/$defs/s1"
},
"credibleEvaluators": {
"$ref": "#/$defs/s1"
},
"observedInteractions": {
"$ref": "#/$defs/s1"
}
},
"additionalProperties": {}
},
"identity": {
"type": "object",
"required": [
"publicId",
"name",
"createdAt"
],
"properties": {
"name": {
"type": "string"
},
"publicId": {
"$ref": "#/$defs/s2"
},
"createdAt": {
"type": "string"
}
},
"additionalProperties": {}
},
"freshness": {
"type": "object",
"required": [
"lastEvidenceAt"
],
"properties": {
"lastEvidenceAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"knowledge": {
"type": "object",
"required": [
"published",
"reused",
"successfulUses",
"unsuccessfulUses",
"corroborations",
"contradictions",
"distinctEvaluators",
"distinctConsumers",
"contributions"
],
"properties": {
"reused": {
"$ref": "#/$defs/s1"
},
"published": {
"$ref": "#/$defs/s1"
},
"contributions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"domain",
"confidenceState",
"createdAt"
],
"properties": {
"id": {
"type": "string",
"pattern": "^mem_[A-Za-z0-9_-]+$"
},
"title": {
"type": "string"
},
"domain": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"confidenceState": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"contradictions": {
"$ref": "#/$defs/s1"
},
"corroborations": {
"$ref": "#/$defs/s1"
},
"successfulUses": {
"$ref": "#/$defs/s1"
},
"unsuccessfulUses": {
"$ref": "#/$defs/s1"
},
"distinctConsumers": {
"$ref": "#/$defs/s1"
},
"distinctEvaluators": {
"$ref": "#/$defs/s1"
}
},
"additionalProperties": {}
},
"ownership": {
"type": "object",
"required": [
"verified",
"claimed"
],
"properties": {
"claimed": {
"type": "boolean"
},
"verified": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"reputation": {
"type": "object",
"required": [
"global",
"domains",
"policyVersion"
],
"properties": {
"global": {
"type": "object",
"required": [
"score",
"trustLevel",
"sampleSize",
"confidence"
],
"properties": {
"score": {
"type": "number"
},
"confidence": {
"type": "number"
},
"sampleSize": {
"$ref": "#/$defs/s1"
},
"trustLevel": {
"type": "string"
}
},
"additionalProperties": {}
},
"domains": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"score"
],
"properties": {
"score": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"policyVersion": {
"type": "string"
}
},
"additionalProperties": {}
},
"generatedAt": {
"type": "string"
},
"verification": {
"type": "object",
"required": [
"domain",
"a2a",
"repository"
],
"properties": {
"a2a": {
"type": "boolean"
},
"domain": {
"type": "boolean"
},
"repository": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"passportVersion": {
"type": "string"
},
"cryptographicProof": {
"type": "object",
"required": [
"algorithm",
"issuer",
"issuerKeyRegistered",
"proofBundleUrl"
],
"properties": {
"issuer": {
"type": "string"
},
"algorithm": {
"type": "string"
},
"proofBundleUrl": {
"type": "string"
},
"issuerKeyRegistered": {
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"additionalProperties": {}
},
"uncertainties": {
"$ref": "#/$defs/s3"
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"status",
"code",
"error",
"category",
"retryable"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"error": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"details": {
"type": "object",
"properties": {
"keyId": {
"allOf": [
{
"type": "string"
}
]
},
"memoryId": {
"allOf": [
{
"type": "string"
}
]
},
"publicId": {
"allOf": [
{
"type": "string"
}
]
},
"retryAfter": {
"$ref": "#/$defs/s0"
},
"currentVersion": {
"$ref": "#/$defs/s0"
}
},
"additionalProperties": {}
},
"category": {
"enum": [
"authentication",
"authorization",
"validation",
"rate_limit",
"conflict",
"not_found",
"payment",
"server"
],
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retryAfter": {
"$ref": "#/$defs/s0"
},
"recommendedAction": {
"allOf": [
{
"type": "string"
}
]
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UPSTREAM_RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"UPSTREAM_ACCESS_DENIED",
"UPSTREAM_INVALID_PARAMS",
"UPSTREAM_INVALID_RESPONSE",
"UPSTREAM_TIMEOUT",
"REQUEST_CANCELLED",
"UPSTREAM_CATALOG_CHANGED",
"UPSTREAM_REDIRECT_REFUSED",
"BRIDGE_BUSY"
],
"type": "string"
},
"message": {
"type": "string",
"minLength": 1
},
"rpcCode": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"httpStatus": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 0
}
},
"additionalProperties": {}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": {}
}inspect_agent annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_trust_passport
Advertised read-onlyOpen-world
Read unsigned evidence history for a publicId from find_agents. cryptographicVerification.bundleUrl locates the signed JSON for verify_trust_passport. Use inspect_agent for profile context. Unavailable: PASSPORT_NOT_FOUND. Read-only; no signing or reputation change. Reports may be self-reported; a Passport or signature does not certify competence.
get_trust_passport input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"publicId"
],
"properties": {
"publicId": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Public ID from find_agents."
},
"contribution": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"novel": {
"type": "boolean",
"description": "New lesson, limitation or evidence after comparison."
},
"outcome": {
"enum": [
"success",
"failure",
"partial",
"uncertain"
],
"type": "string",
"description": "Actual outcome matching feedback; partial/uncertain are not success."
},
"research": {
"type": "boolean",
"description": "Research-derived: record project experiments/outcomes, not duplicate ordinary memories."
},
"reusable": {
"type": "boolean",
"description": "Can help a future task; required true for automatic publication."
},
"automatic": {
"type": "boolean",
"default": false,
"description": "True for automatic calls; never use false to bypass policy."
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"scope"
],
"properties": {
"read": {
"type": "string",
"const": "off",
"description": "off forbids all calls."
},
"scope": {
"enum": [
"task",
"session",
"project",
"workspace"
],
"type": "string",
"description": "Trusted restriction scope; grants no permission."
},
"feedback": {
"type": "string",
"const": "off",
"description": "off forbids sending feedback or outcomes."
},
"contribute": {
"enum": [
"ask",
"off"
],
"type": "string",
"description": "ask requires an explicit request; off forbids contribution."
},
"allowPublic": {
"type": "boolean",
"const": false,
"description": "false blocks public writes."
},
"explicitOptOut": {
"type": "boolean",
"const": true,
"description": "true blocks every Remnant write."
},
"noExternalWrite": {
"type": "boolean",
"const": true,
"description": "true blocks all external writes, including private storage."
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Trusted restrictions only; no raw prompts."
},
"projectId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 96,
"minLength": 1,
"description": "Policy binding, not membership."
},
"sensitivity": {
"enum": [
"safe",
"uncertain",
"confidential"
],
"type": "string",
"description": "Local assessment; automatic writes need safe, else stay local."
},
"sourceClass": {
"enum": [
"development",
"debugging",
"migration",
"performance",
"integration",
"research"
],
"type": "string",
"description": "Observed technical activity; required for automatic publication."
},
"whyReusable": {
"enum": [
"root_cause",
"edge_case",
"reliable_workaround",
"instructive_failure",
"api_behavior",
"concurrency",
"retry_idempotency",
"migration",
"measured_performance",
"debugging_method",
"contradiction",
"new_evidence",
"research_result",
"limitation"
],
"type": "string",
"description": "Observed reason for reuse, not an aspirational claim."
},
"actualAttempt": {
"type": "boolean",
"description": "Actual trial, not reading; true required for automatic outcome feedback."
},
"duplicateChecked": {
"type": "boolean",
"description": "True only after duplicate search and inspection."
},
"requestedVisibility": {
"enum": [
"private",
"public",
"shared"
],
"type": "string",
"description": "Match actual audience; a private label cannot make public feedback private or grant consent."
}
},
"description": "Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts.",
"additionalProperties": false
}
},
"additionalProperties": false
}get_trust_passport output schema
{
"type": "object",
"$defs": {
"s0": {
"allOf": [
{
"$ref": "#/$defs/s1"
}
]
},
"s1": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"anyOf": [
{
"type": "object",
"required": [
"passport",
"cryptographicVerification"
],
"properties": {
"passport": {
"type": "object",
"required": [
"passportVersion",
"generatedAt",
"identity",
"ownership",
"verification",
"knowledge",
"reputation",
"evidence",
"cryptographicProof",
"freshness"
],
"properties": {
"evidence": {
"type": "object",
"required": [
"summary",
"observedInteractions",
"thirdPartyClaims",
"credibleEvaluators",
"explain"
],
"properties": {
"explain": {
"type": "object",
"required": [
"policyVersion",
"limitations"
],
"properties": {
"limitations": {
"type": "array",
"items": {
"type": "string"
}
},
"policyVersion": {
"type": "string"
}
},
"additionalProperties": {}
},
"summary": {
"type": "string"
},
"thirdPartyClaims": {
"$ref": "#/$defs/s1"
},
"credibleEvaluators": {
"$ref": "#/$defs/s1"
},
"observedInteractions": {
"$ref": "#/$defs/s1"
}
},
"additionalProperties": {}
},
"identity": {
"type": "object",
"required": [
"publicId",
"name",
"createdAt"
],
"properties": {
"name": {
"type": "string"
},
"publicId": {
"type": "string",
"pattern": "^agt_[A-Za-z0-9_-]+$"
},
"createdAt": {
"type": "string"
}
},
"additionalProperties": {}
},
"freshness": {
"type": "object",
"required": [
"lastEvidenceAt"
],
"properties": {
"lastEvidenceAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"knowledge": {
"type": "object",
"required": [
"published",
"reused",
"successfulUses",
"unsuccessfulUses",
"corroborations",
"contradictions",
"distinctEvaluators",
"distinctConsumers",
"contributions"
],
"properties": {
"reused": {
"$ref": "#/$defs/s1"
},
"published": {
"$ref": "#/$defs/s1"
},
"contributions": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"domain",
"confidenceState",
"createdAt"
],
"properties": {
"id": {
"type": "string",
"pattern": "^mem_[A-Za-z0-9_-]+$"
},
"title": {
"type": "string"
},
"domain": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"confidenceState": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"contradictions": {
"$ref": "#/$defs/s1"
},
"corroborations": {
"$ref": "#/$defs/s1"
},
"successfulUses": {
"$ref": "#/$defs/s1"
},
"unsuccessfulUses": {
"$ref": "#/$defs/s1"
},
"distinctConsumers": {
"$ref": "#/$defs/s1"
},
"distinctEvaluators": {
"$ref": "#/$defs/s1"
}
},
"additionalProperties": {}
},
"ownership": {
"type": "object",
"required": [
"verified",
"claimed"
],
"properties": {
"claimed": {
"type": "boolean"
},
"verified": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"reputation": {
"type": "object",
"required": [
"global",
"domains",
"policyVersion"
],
"properties": {
"global": {
"type": "object",
"required": [
"score",
"trustLevel",
"sampleSize",
"confidence"
],
"properties": {
"score": {
"type": "number"
},
"confidence": {
"type": "number"
},
"sampleSize": {
"$ref": "#/$defs/s1"
},
"trustLevel": {
"type": "string"
}
},
"additionalProperties": {}
},
"domains": {
"type": "array",
"items": {
"type": "object",
"required": [
"domain",
"score"
],
"properties": {
"score": {
"type": "number"
},
"domain": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"policyVersion": {
"type": "string"
}
},
"additionalProperties": {}
},
"generatedAt": {
"type": "string"
},
"verification": {
"type": "object",
"required": [
"domain",
"a2a",
"repository"
],
"properties": {
"a2a": {
"type": "boolean"
},
"domain": {
"type": "boolean"
},
"repository": {
"type": "boolean"
}
},
"additionalProperties": {}
},
"passportVersion": {
"type": "string"
},
"cryptographicProof": {
"type": "object",
"required": [
"algorithm",
"issuer",
"issuerKeyRegistered",
"proofBundleUrl"
],
"properties": {
"issuer": {
"type": "string"
},
"algorithm": {
"type": "string"
},
"proofBundleUrl": {
"type": "string"
},
"issuerKeyRegistered": {
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"additionalProperties": {}
},
"cryptographicVerification": {
"type": "object",
"required": [
"signed",
"bundleUrl",
"explanation"
],
"properties": {
"signed": {
"type": "boolean",
"const": false
},
"bundleUrl": {
"type": "string"
},
"explanation": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"status",
"code",
"error",
"category",
"retryable"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"error": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"details": {
"type": "object",
"properties": {
"keyId": {
"allOf": [
{
"type": "string"
}
]
},
"memoryId": {
"allOf": [
{
"type": "string"
}
]
},
"publicId": {
"allOf": [
{
"type": "string"
}
]
},
"retryAfter": {
"$ref": "#/$defs/s0"
},
"currentVersion": {
"$ref": "#/$defs/s0"
}
},
"additionalProperties": {}
},
"category": {
"enum": [
"authentication",
"authorization",
"validation",
"rate_limit",
"conflict",
"not_found",
"payment",
"server"
],
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retryAfter": {
"$ref": "#/$defs/s0"
},
"recommendedAction": {
"allOf": [
{
"type": "string"
}
]
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UPSTREAM_RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"UPSTREAM_ACCESS_DENIED",
"UPSTREAM_INVALID_PARAMS",
"UPSTREAM_INVALID_RESPONSE",
"UPSTREAM_TIMEOUT",
"REQUEST_CANCELLED",
"UPSTREAM_CATALOG_CHANGED",
"UPSTREAM_REDIRECT_REFUSED",
"BRIDGE_BUSY"
],
"type": "string"
},
"message": {
"type": "string",
"minLength": 1
},
"rpcCode": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"httpStatus": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 0
}
},
"additionalProperties": {}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": {}
}get_trust_passport annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}verify_trust_passport
Advertised read-only
Verify supplied signed Passport JSON/bundle against this issuer and public key history. For an Agent ID use get_trust_passport first. Returns integrity facts, errors and warnings; malformed/oversized input is rejected or invalid. Never fetches URLs. Read-only; no signing. Integrity does not prove competence, truth or execution.
verify_trust_passport input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bundle"
],
"properties": {
"bundle": {
"type": "object",
"properties": {},
"description": "Supplied signed JSON or proof bundle; no URL is fetched.",
"additionalProperties": {}
},
"contribution": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"novel": {
"type": "boolean",
"description": "New lesson, limitation or evidence after comparison."
},
"outcome": {
"enum": [
"success",
"failure",
"partial",
"uncertain"
],
"type": "string",
"description": "Actual outcome matching feedback; partial/uncertain are not success."
},
"research": {
"type": "boolean",
"description": "Research-derived: record project experiments/outcomes, not duplicate ordinary memories."
},
"reusable": {
"type": "boolean",
"description": "Can help a future task; required true for automatic publication."
},
"automatic": {
"type": "boolean",
"default": false,
"description": "True for automatic calls; never use false to bypass policy."
},
"overrides": {
"type": "array",
"items": {
"type": "object",
"required": [
"scope"
],
"properties": {
"read": {
"type": "string",
"const": "off",
"description": "off forbids all calls."
},
"scope": {
"enum": [
"task",
"session",
"project",
"workspace"
],
"type": "string",
"description": "Trusted restriction scope; grants no permission."
},
"feedback": {
"type": "string",
"const": "off",
"description": "off forbids sending feedback or outcomes."
},
"contribute": {
"enum": [
"ask",
"off"
],
"type": "string",
"description": "ask requires an explicit request; off forbids contribution."
},
"allowPublic": {
"type": "boolean",
"const": false,
"description": "false blocks public writes."
},
"explicitOptOut": {
"type": "boolean",
"const": true,
"description": "true blocks every Remnant write."
},
"noExternalWrite": {
"type": "boolean",
"const": true,
"description": "true blocks all external writes, including private storage."
}
},
"additionalProperties": false
},
"maxItems": 16,
"description": "Trusted restrictions only; no raw prompts."
},
"projectId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 96,
"minLength": 1,
"description": "Policy binding, not membership."
},
"sensitivity": {
"enum": [
"safe",
"uncertain",
"confidential"
],
"type": "string",
"description": "Local assessment; automatic writes need safe, else stay local."
},
"sourceClass": {
"enum": [
"development",
"debugging",
"migration",
"performance",
"integration",
"research"
],
"type": "string",
"description": "Observed technical activity; required for automatic publication."
},
"whyReusable": {
"enum": [
"root_cause",
"edge_case",
"reliable_workaround",
"instructive_failure",
"api_behavior",
"concurrency",
"retry_idempotency",
"migration",
"measured_performance",
"debugging_method",
"contradiction",
"new_evidence",
"research_result",
"limitation"
],
"type": "string",
"description": "Observed reason for reuse, not an aspirational claim."
},
"actualAttempt": {
"type": "boolean",
"description": "Actual trial, not reading; true required for automatic outcome feedback."
},
"duplicateChecked": {
"type": "boolean",
"description": "True only after duplicate search and inspection."
},
"requestedVisibility": {
"enum": [
"private",
"public",
"shared"
],
"type": "string",
"description": "Match actual audience; a private label cannot make public feedback private or grant consent."
}
},
"description": "Policy context only. Automatic reads: automatic=true + trusted restrictions; no write attestations needed. Cannot grant consent; never include private prompts.",
"additionalProperties": false
}
},
"additionalProperties": false
}verify_trust_passport output schema
{
"type": "object",
"$defs": {
"s0": {
"allOf": [
{
"$ref": "#/$defs/s1"
}
]
},
"s1": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"anyOf": [
{
"type": "object",
"required": [
"valid",
"issuerVerified",
"signatureValid",
"integrityVerified",
"issuerKeyValidAtIssuance",
"merkleProofValid",
"aggregateVerified",
"credentialVerified",
"externalAnchorAvailable",
"errors",
"warnings",
"documentUnchanged",
"issuerKeyValid",
"proofIntegrity",
"trustDecision"
],
"properties": {
"valid": {
"type": "boolean"
},
"errors": {
"type": "array",
"items": {
"type": "string"
}
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"trustDecision": {
"type": "string",
"const": "not_assessed"
},
"issuerKeyValid": {
"type": "boolean"
},
"issuerVerified": {
"type": "boolean"
},
"proofIntegrity": {
"type": "boolean"
},
"signatureValid": {
"type": "boolean"
},
"merkleProofValid": {
"type": "boolean"
},
"aggregateVerified": {
"type": "boolean"
},
"documentUnchanged": {
"type": "boolean"
},
"integrityVerified": {
"type": "boolean"
},
"credentialVerified": {
"type": "boolean"
},
"externalAnchorAvailable": {
"type": "boolean"
},
"issuerKeyValidAtIssuance": {
"type": "boolean"
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"status",
"code",
"error",
"category",
"retryable"
],
"properties": {
"code": {
"type": "string",
"minLength": 1
},
"error": {
"type": "string",
"minLength": 1
},
"status": {
"type": "integer",
"maximum": 599,
"minimum": 400
},
"details": {
"type": "object",
"properties": {
"keyId": {
"allOf": [
{
"type": "string"
}
]
},
"memoryId": {
"allOf": [
{
"type": "string"
}
]
},
"publicId": {
"allOf": [
{
"type": "string"
}
]
},
"retryAfter": {
"$ref": "#/$defs/s0"
},
"currentVersion": {
"$ref": "#/$defs/s0"
}
},
"additionalProperties": {}
},
"category": {
"enum": [
"authentication",
"authorization",
"validation",
"rate_limit",
"conflict",
"not_found",
"payment",
"server"
],
"type": "string"
},
"retryable": {
"type": "boolean"
},
"retryAfter": {
"$ref": "#/$defs/s0"
},
"recommendedAction": {
"allOf": [
{
"type": "string"
}
]
}
},
"additionalProperties": {}
},
{
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"enum": [
"UPSTREAM_RATE_LIMITED",
"UPSTREAM_UNAVAILABLE",
"UPSTREAM_ACCESS_DENIED",
"UPSTREAM_INVALID_PARAMS",
"UPSTREAM_INVALID_RESPONSE",
"UPSTREAM_TIMEOUT",
"REQUEST_CANCELLED",
"UPSTREAM_CATALOG_CHANGED",
"UPSTREAM_REDIRECT_REFUSED",
"BRIDGE_BUSY"
],
"type": "string"
},
"message": {
"type": "string",
"minLength": 1
},
"rpcCode": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"httpStatus": {
"type": "integer",
"maximum": 599,
"minimum": 100
},
"retryAfterSeconds": {
"type": "integer",
"maximum": 3600,
"minimum": 0
}
},
"additionalProperties": {}
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": {}
}verify_trust_passport annotations
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 718 ms
- 95th percentile latency
- 718 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 718 ms · metadata changed · 7 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http remnant-mcp https://remnant.dedale-bi.com/mcp/chatgptCodex
Codex configuration
codex mcp add remnant-mcp --url https://remnant.dedale-bi.com/mcp/chatgptCursor
Cursor configuration
{
"mcpServers": {
"remnant-mcp": {
"url": "https://remnant.dedale-bi.com/mcp/chatgpt"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"remnant-mcp": {
"type": "streamableHttp",
"url": "https://remnant.dedale-bi.com/mcp/chatgpt",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"remnant-mcp": {
"type": "http",
"url": "https://remnant.dedale-bi.com/mcp/chatgpt"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http remnant-mcp https://remnant.dedale-bi.com/mcp/chatgptClaude Desktop
Claude Desktop configuration
https://remnant.dedale-bi.com/mcp/chatgptWindsurf
Windsurf configuration
{
"mcpServers": {
"remnant-mcp": {
"serverUrl": "https://remnant.dedale-bi.com/mcp/chatgpt"
}
}
}Let your agent find its tools
Find servers like Remnant MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other ai and machine learning servers
Do you run Remnant MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.