MCP Server

NAIF Agent Gravity — Free MCP Diagnostic & Recovery

io.github.naief9961-tech/naif-fixgraph
MCP & Agent Infrastructure Security Public & reachable MCP 2025-11-25

What this MCP does

Provides structured agent diagnostics, technical error recovery guidance, signed task handoffs, trust passports, delegation checks, and privacy-preserving traffic telemetry.

agent_compatibility_check
Agent Compatibility Check
Diagnose Agent-to-MCP tool schema, capability and interoperability failures.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['text'], 'properties': {'text': {'type': 'string', 'maxLength': 3000, 'minLength': 3, 'description': 'Sanitized, non-sensitive technical symptoms only.'}}}
api_auth_rescue
API/Auth Rescue
Diagnose API 401, 403, 429, 5xx, OAuth, API authentication and rate-limit failures.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['text'], 'properties': {'text': {'type': 'string', 'maxLength': 3000, 'minLength': 3, 'description': 'Sanitized, non-sensitive technical symptoms only.'}}}
checkpoint_agent_task
Checkpoint Agent Task
Add a bounded progress checkpoint to an existing continuity capsule without resending the full task history.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['capsule'], 'properties': {'capsule': {'type': 'string', 'maxLength': 32000, 'minLength': 40}, 'nextAction': {'type': 'string', 'maxLength': 600}, 'completedAdd': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320}, 'maxItems': 20}, 'remainingAdd': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320}, 'maxItems': 20}, 'constraintsAdd': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320}, 'maxItems': 20}, 'verifiedFactsAdd': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320}, 'maxItems': 20}, 'remainingDoneIndices': {'type': 'array', 'items': {'type': 'integer', 'maximum': 19, 'minimum': 0}, 'maxItems': 20}, 'requiredCapabilitiesAdd': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9_:-]{2,64}$'}, 'maxItems': 20}}}
create_handoff_capsule
Create Handoff Capsule
Create a signed sanitized cross-agent task capsule. The continuity ledger stores only hashes and transition metadata, not the task text.
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['goal'], 'properties': {'goal': {'type': 'string', 'maxLength': 1200, 'minLength': 3}, 'completed': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320}, 'maxItems': 20}, 'remaining': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320}, 'maxItems': 20}, 'nextAction': {'type': 'string', 'maxLength': 600}, 'constraints': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320}, 'maxItems': 20}, 'verifiedFacts': {'type': 'array', 'items': {'type': 'string', 'maxLength': 320}, 'maxItems': 20}, 'requiredCapabilities': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[a-z0-9_:-]{2,64}$'}, 'maxItems': 20}}}
delegation_preflight
Delegation Preflight
Re-check an opted-in agent from a valid NAIF Trust Passport and return a five-minute signed delegation preflight with current technical facts.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['passport'], 'properties': {'passport': {'type': 'string', 'maxLength': 16000, 'minLength': 40}}}
get_agent_traffic_feed
Get Agent Traffic Feed
Read current aggregate traffic observations that have reached the public minimum sample threshold.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
get_agent_trust_passport
Get Agent Trust Passport
Issue a signed point-in-time technical passport only for an agent domain that explicitly opts in through its own /.well-known/naif-trust.json. This is not a ranking, endorsement, or security audit.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['agentCardUrl'], 'properties': {'agentCardUrl': {'type': 'string', 'format': 'uri', 'maxLength': 500}}}
get_repair_packet
Get Repair Packet
Return a bounded machine-readable repair packet for a known FixGraph slug.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 120, 'minLength': 3}}}
handoff_agent_task
Handoff Agent Task
Issue the next signed continuity capsule and optionally bind it to an opted-in recipient agent after NAIF Trust Passport and five-minute delegation preflight checks.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['capsule'], 'properties': {'capsule': {'type': 'string', 'maxLength': 32000, 'minLength': 40}, 'recipientAgentCardUrl': {'type': 'string', 'format': 'uri', 'maxLength': 500}}}
list_fix_topics
List FixGraph Topics
List the public technical problem topics currently handled by NAIF FixGraph.
Read only Idempotent
Input schema
{'type': 'object', 'properties': {}}
mcp_health_repair
MCP Health & Repair
Diagnose MCP connection, tool schema, timeout and capability failures and return bounded repair guidance.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['text'], 'properties': {'text': {'type': 'string', 'maxLength': 3000, 'minLength': 3, 'description': 'Sanitized, non-sensitive technical symptoms only.'}}}
report_traffic_observation
Report Agent Traffic Observation
Record an aggregate technical route outcome using only the structured fields defined below. This tool accepts route class, outcome, optional failure class, region, chain and latency bucket.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['routeType', 'targetClass', 'outcome'], 'properties': {'chain': {'type': 'string', 'pattern': '^[a-z0-9_-]{2,32}$'}, 'region': {'type': 'string', 'pattern': '^[A-Z]{2}$'}, 'outcome': {'enum': ['success', 'failure'], 'type': 'string'}, 'routeType': {'enum': ['api', 'rpc', 'mcp', 'a2a', 'webhook'], 'type': 'string'}, 'targetClass': {'enum': ['general_api', 'evm_rpc', 'mcp_server', 'a2a_agent', 'webhook_receiver', 'agent_backend'], 'type': 'string'}, 'failureClass': {'enum': ['timeout', 'rate_limit', 'dns', 'tls', 'http_5xx', 'http_4xx', 'protocol_error', 'unavailable', 'high_latency', 'other'], 'type': 'string'}, 'latencyBucket': {'enum': ['lt250ms', '250ms_1s', '1s_3s', 'gt3s', 'timeout', 'unknown'], 'type': 'string'}}}
resolve_technical_error
Resolve Technical Error
Sanitize and match an API or webhook error to FixGraph. Returns machine-readable repair packets. Does not execute changes.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['text'], 'properties': {'text': {'type': 'string', 'maxLength': 4000, 'minLength': 3, 'description': 'Sanitized, non-sensitive technical error text only.'}, 'source': {'type': 'string', 'maxLength': 80, 'description': 'Optional short attribution label.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['schemaVersion', 'gateway', 'rawInputStored', 'autoExecution', 'autoPublish', 'sanitizedPreview', 'matches'], 'properties': {'safety': {}, 'gateway': {'type': 'string'}, 'matches': {'type': 'array', 'items': {}}, 'candidate': {'anyOf': [{}, {'type': 'null'}]}, 'agentMarket': {}, 'autoPublish': {'type': 'boolean'}, 'autoExecution': {'type': 'boolean'}, 'rescueReceipt': {}, 'schemaVersion': {'type': 'string'}, 'rawInputStored': {'type': 'boolean'}, 'sanitizedPreview': {'type': 'string'}}, 'additionalProperties': False}
resume_agent_task
Resume Agent Task
Verify and unpack a signed NAIF continuity capsule so another agent can resume from its sanitized state.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['capsule'], 'properties': {'capsule': {'type': 'string', 'maxLength': 32000, 'minLength': 40}}}
traffic_preflight
Agent Traffic Preflight
Query recent privacy-preserving aggregate route telemetry before starting agent work. Absence of a signal is not proof of health.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['routeType', 'targetClass'], 'properties': {'chain': {'type': 'string', 'pattern': '^[a-z0-9_-]{2,32}$'}, 'region': {'type': 'string', 'pattern': '^[A-Z]{2}$'}, 'routeType': {'enum': ['api', 'rpc', 'mcp', 'a2a', 'webhook'], 'type': 'string'}, 'targetClass': {'enum': ['general_api', 'evm_rpc', 'mcp_server', 'a2a_agent', 'webhook_receiver', 'agent_backend'], 'type': 'string'}, 'windowMinutes': {'type': 'integer', 'maximum': 60, 'minimum': 1}}}
verify_handoff_capsule
Verify Handoff Capsule
Verify a NAIF continuity capsule signature, validity window and embedded state hash.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['capsule'], 'properties': {'capsule': {'type': 'string', 'maxLength': 32000, 'minLength': 40}}}
verify_trust_token
Verify NAIF Trust Token
Verify the signature and validity window of a NAIF Trust Passport or Delegation Preflight token.
Read only Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['token'], 'properties': {'token': {'type': 'string', 'maxLength': 16000, 'minLength': 40}}}
webhook_rescue
Webhook Rescue
Diagnose webhook delivery, signature, retry, duplicate-event and schema failures.
Open world
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['text'], 'properties': {'text': {'type': 'string', 'maxLength': 3000, 'minLength': 3, 'description': 'Sanitized, non-sensitive technical symptoms only.'}}}
Removed
get_dynamic_agent_offers
Sept. 29, 2026, 2:48 a.m.
Removed
get_agent_market_state
Sept. 29, 2026, 2:48 a.m.
Removed
accept_agent_offer
Sept. 29, 2026, 2:48 a.m.
Changed
report_traffic_observation
Sept. 29, 2026, 2:48 a.m.
Added
agent_compatibility_check
Sept. 29, 2026, 2:48 a.m.
Added
webhook_rescue
Sept. 29, 2026, 2:48 a.m.
Added
api_auth_rescue
Sept. 29, 2026, 2:48 a.m.
Added
mcp_health_repair
Sept. 29, 2026, 2:48 a.m.
Changed
resolve_technical_error
Sept. 29, 2026, 2:48 a.m.
Added
get_agent_market_state
Sept. 27, 2026, 2:40 a.m.
Added
accept_agent_offer
Sept. 27, 2026, 2:40 a.m.
Added
get_dynamic_agent_offers
Sept. 27, 2026, 2:40 a.m.
Added
verify_handoff_capsule
Sept. 27, 2026, 2:40 a.m.
Added
handoff_agent_task
Sept. 27, 2026, 2:40 a.m.
Added
checkpoint_agent_task
Sept. 27, 2026, 2:40 a.m.
Added
resume_agent_task
Sept. 27, 2026, 2:40 a.m.
Added
create_handoff_capsule
Sept. 27, 2026, 2:40 a.m.
Added
get_agent_traffic_feed
Sept. 27, 2026, 2:40 a.m.
Added
traffic_preflight
Sept. 27, 2026, 2:40 a.m.
Added
report_traffic_observation
Sept. 27, 2026, 2:40 a.m.
Added
verify_trust_token
Sept. 27, 2026, 2:40 a.m.
Added
delegation_preflight
Sept. 27, 2026, 2:40 a.m.
Added
get_agent_trust_passport
Sept. 27, 2026, 2:40 a.m.
Added
list_fix_topics
Sept. 27, 2026, 2:40 a.m.
Added
get_repair_packet
Sept. 27, 2026, 2:40 a.m.
Added
resolve_technical_error
Sept. 27, 2026, 2:40 a.m.