FeedOracle Compliance Agent

Quick connectivity test. Returns server version, uptime, and available tool count. No auth required.

{
  "type": "object",
  "properties": {}
}

Pre-flight regulatory check. Returns PASS/WARN/BLOCK with reason_codes, sources, confidence. Not legal advice.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Token symbol e.g. USDC, RLUSD, USDT"
    },
    "action": {
      "type": "string",
      "default": "swap",
      "description": "Action type: swap, transfer, custody"
    },
    "jurisdiction": {
      "type": "string",
      "default": "EU",
      "description": "Jurisdiction: EU, US, UK"
    }
  },
  "required": [
    "token_symbol"
  ]
}

MiCA EU authorization status. Cross-referenced with ESMA/EBA registers.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Stablecoin symbol e.g. USDC, EURC, USDT"
    }
  },
  "required": [
    "token_symbol"
  ]
}

Multi-dimensional evidence profile: governance, custody, reserves, market depth. Grade A-F.

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "description": "Protocol name or slug e.g. usdc, aave, ondo-usdy"
    }
  },
  "required": [
    "protocol"
  ]
}

Custody & counterparty risk assessment. SIFI status, concentration risk. DORA Art.28 relevant.

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "description": "Protocol name or slug"
    }
  },
  "required": [
    "protocol"
  ]
}

DEX liquidity depth & exit channel analysis. MiCA Art.45 relevant.

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string",
      "description": "Protocol name or slug"
    }
  },
  "required": [
    "protocol"
  ]
}

Top protocols ranked by evidence grade A-F across 61 RWA protocols & 105+ stablecoins.

{
  "type": "object",
  "properties": {
    "top_n": {
      "type": "integer",
      "default": 15,
      "description": "Number of top protocols to return"
    }
  }
}

RLUSD real-time integrity monitoring & attestation verification.

{
  "type": "object",
  "properties": {}
}

US macro risk composite from 86 FRED economic series.

{
  "type": "object",
  "properties": {}
}

Real-time peg deviation for any stablecoin. MiCA Art. 35: issuers must maintain peg at all times. Returns deviation %, status (STABLE/WARN/ALERT/CRITICAL), 30-day history summary.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Token symbol e.g. EURC, USDT, EURe"
    }
  },
  "required": [
    "token_symbol"
  ]
}

MiCA Art. 45 (ART) / Art. 58 (EMT): checks if issuer exceeds €5B reserve threshold. Significant issuers require EBA oversight and 3% own-funds. Returns threshold%, days-to-significant projection, and additional obligations.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Token symbol e.g. USDC, USDT, EURC"
    }
  },
  "required": [
    "token_symbol"
  ]
}

MiCA Art. 23 (ART) / Art. 52 (EMT): scans for issuer-native yield mechanisms. Issuers are prohibited from paying interest to token holders. Returns risk level NONE/LOW/MEDIUM/HIGH with explanation.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Token symbol e.g. USD0++, USDT, EURC"
    }
  },
  "required": [
    "token_symbol"
  ]
}

MiCA Art. 29/30 (ART): recovery & redemption plans. Art. 55 (EMT): annual independent audit. Returns compliance score 0-100, audit freshness, plan status, and any stale/missing document alerts.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Token symbol e.g. EURC, USDT, BUIDL"
    }
  },
  "required": [
    "token_symbol"
  ]
}

MiCA Art. 24/25 (ART): reserve management policy. Art. 53 (EMT): 100%% in deposits or highly liquid low-risk assets. Returns Art. 53 eligibility %%, liquidity score, asset mix, and any violations.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Token symbol e.g. EURC, EURCV, USDC"
    }
  },
  "required": [
    "token_symbol"
  ]
}

[HEAVY|KEY] Complete MiCA compliance evidence for one token (12 MiCA articles). Aggregates: Art. 35 peg + Art. 45/58 significant + Art. 23/52 interest + Art. 29/30/55 documents + Art. 24/25/53 reserves. Returns overall_mica_compliant flag and compliance_flags list. Ideal for due diligence.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Token symbol e.g. EURC, USDC, EURe, RLUSD"
    }
  },
  "required": [
    "token_symbol"
  ]
}

[HEAVY|KEY] Full MiCA market status: peg alerts, significant issuers, interest prohibition violations, stale audits, reserve violations, issuer revenue flags. Best entry point for compliance monitoring dashboards.

{
  "type": "object",
  "properties": {}
}

30-day peg deviation history for a stablecoin. MiCA Art. 35 requires continuous peg maintenance. Returns daily deviation, max/min/avg, stability score 0-100, and depeg event count.

{
  "type": "object",
  "properties": {
    "token_symbol": {
      "type": "string",
      "description": "Token symbol e.g. USDT, EURC, EURe"
    }
  },
  "required": [
    "token_symbol"
  ]
}

[HEAVY|KEY] Generate a signed, XRPL-anchored PDF compliance report. Creates a new document. Requires API key for Professional/Enterprise tiers.

{
  "type": "object",
  "properties": {
    "report_type": {
      "type": "string",
      "default": "mica",
      "description": "Report type: mica, dora, rwa_risk, macro_risk, csrd"
    }
  }
}

[GATEWAY|AUDIT] Full cryptographic provenance chain for an asset's evidence data. Traces every data point from external source (FRED series ID, ESMA register, CoinGecko, on-chain) through FeedOracle processing to final bundle. Each node individually SHA256-hashed. Chain hash = merkle-style hash of all nodes. Tamper-proof audit trail for EU AI Act explainability + MiCA evidence requirements. Returns: series_ids, providers, external_sources, per-node hashes, chain_hash.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Token symbol: EURC, USDC, RLUSD etc."
    },
    "frameworks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "mica, dora, rwa, macro, stablecoin_risk — default: mica+macro",
      "default": [
        "mica",
        "macro"
      ]
    }
  },
  "required": [
    "symbol"
  ]
}

[GATEWAY] Explains WHY an asset has a specific compliance grade. Returns dimension-by-dimension breakdown (custody, reserve, control, liquidity, market_depth, asset_registry, reserve_proof), MiCA article compliance flags, key strengths, key weaknesses, and a counterfactual Grade A path with specific actions. EU AI Act explainability-compliant. Use after evidence_bundle or ai_query to understand scores.

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "Token symbol: EURC, USDC, RLUSD, USDT etc."
    }
  },
  "required": [
    "symbol"
  ]
}

[GATEWAY|KEY] Single-call multi-framework evidence aggregation. Fetches MiCA, DORA, RWA, Macro and Stablecoin Risk evidence in one signed bundle. Returns FO-EVB-* bundle ID + SHA256 hash + per-framework status. Enterprise due diligence in one call. frameworks: mica, dora, rwa, macro, stablecoin_risk (or 'all'). Replaces 23 individual API calls.

{
  "type": "object",
  "properties": {
    "asset": {
      "type": "string",
      "description": "Token symbol: USDC, EURC, RLUSD, USDT etc."
    },
    "frameworks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Frameworks to include: mica, dora, rwa, macro, stablecoin_risk — or omit for all",
      "default": [
        "mica",
        "dora",
        "rwa",
        "macro",
        "stablecoin_risk"
      ]
    }
  },
  "required": [
    "asset"
  ]
}

Log a decision your agent made, linking it to evidence from prior tool calls. Creates a tamper-proof, chain-linked audit entry. Pass request_ids from prior tool calls to snapshot the evidence basis. Regulators can verify the chain. Returns trail_id and chain_hash.

{
  "type": "object",
  "properties": {
    "decision_type": {
      "type": "string",
      "description": "compliance_check, risk_assessment, trade_signal, alert, recommendation, custom",
      "default": "compliance_check"
    },
    "decision": {
      "type": "string",
      "description": "PASS, BLOCK, WARN, HOLD, BUY, SELL, or custom"
    },
    "reasoning": {
      "type": "string",
      "description": "Why this decision was made — free text explanation"
    },
    "action_taken": {
      "type": "string",
      "description": "What action was or will be taken based on this decision"
    },
    "target_asset": {
      "type": "string",
      "description": "Asset symbol e.g. USDC, EURC"
    },
    "jurisdiction": {
      "type": "string",
      "description": "EU, US, UK etc.",
      "default": "EU"
    },
    "evidence_request_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "request_ids (fo-...) from prior tool calls used as evidence basis"
    }
  },
  "required": [
    "decision",
    "reasoning",
    "evidence_request_ids"
  ]
}

Query your agent's audit trail history. Returns chain-linked decision log with evidence snapshots. Filter by asset or decision type. Use audit_verify to check chain integrity.

{
  "type": "object",
  "properties": {
    "client_id": {
      "type": "string",
      "description": "Agent client_id to query"
    },
    "target_asset": {
      "type": "string",
      "description": "Filter by asset symbol"
    },
    "decision_type": {
      "type": "string",
      "description": "Filter by decision type"
    },
    "limit": {
      "type": "integer",
      "description": "Max results (default 20)",
      "default": 20
    }
  },
  "required": [
    "client_id"
  ]
}

Cryptographically verify that an agent's audit trail has not been tampered with. Checks chain hash linkage from genesis to head. Returns valid/invalid with break point if tampered.

{
  "type": "object",
  "properties": {
    "client_id": {
      "type": "string",
      "description": "Agent client_id to verify"
    }
  },
  "required": [
    "client_id"
  ]
}

Register your AI agent's identity and purpose to unlock trust-gated tools. Provide agent metadata (name, purpose, org, jurisdiction) to receive a trust score and access level. Higher trust = more tools. Required for evidence_bundle, generate_report, mica_full_pack, ai_provenance, ai_explain.

{
  "type": "object",
  "properties": {
    "agent_name": {
      "type": "string",
      "description": "Your agent's name e.g. MiCA Compliance Bot"
    },
    "agent_purpose": {
      "type": "string",
      "description": "What your agent does e.g. Automated MiCA compliance monitoring"
    },
    "owner_org": {
      "type": "string",
      "description": "Organization name"
    },
    "owner_email": {
      "type": "string",
      "description": "Contact email"
    },
    "owner_jurisdiction": {
      "type": "string",
      "description": "Jurisdiction: DE, AT, CH, US, EU etc."
    },
    "compliance_contact": {
      "type": "string",
      "description": "Compliance officer email"
    },
    "website_url": {
      "type": "string",
      "description": "Organization website"
    },
    "risk_appetite": {
      "type": "string",
      "description": "conservative, moderate, or aggressive",
      "default": "conservative"
    }
  },
  "required": [
    "agent_name",
    "agent_purpose",
    "owner_org",
    "owner_email"
  ]
}

Check your agent's current KYA trust level, score breakdown, and tool access. Shows which tools are available at your trust level and what to do to unlock more.

{
  "type": "object",
  "properties": {
    "client_id": {
      "type": "string",
      "description": "Your OAuth client_id (from registration)"
    }
  },
  "required": [
    "client_id"
  ]
}

[GATEWAY] Natural language evidence query. Routes any plain-English question to the correct FeedOracle evidence APIs automatically. Two-tier classifier: regex (fast) + DeepSeek LLM fallback for complex queries. Returns signed evidence bundle (SHA256 + pack_id). No hallucinations — data from verified FeedOracle APIs. Examples: IsUSDS MiCA compliant? / What is recession risk? / Evaluate EURC for treasury.

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Natural language question e.g. Is USDC MiCA compliant?, What is peg status of EURC?, Current recession risk?"
    },
    "symbol": {
      "type": "string",
      "description": "Optional token symbol override: USDC, EURC, RLUSD etc."
    }
  },
  "required": [
    "question"
  ]
}

Generate a Zero-Knowledge proof that reserve ratio exceeds a threshold — without revealing exact amounts. Bound to latest on-chain RLUSD snapshot. MiCA Art.36 / DORA Art.28. Circuit: reserve_guard_v1 on Polygon. Returns proof hash, public inputs, snapshot binding.

{
  "type": "object",
  "properties": {
    "min_ratio": {
      "type": "integer",
      "default": 100,
      "description": "Minimum reserve ratio % to prove e.g. 100"
    }
  }
}

Verify the latest generated ZK solvency proof cryptographically via Noir circuit verifier. Returns valid/invalid and verifier version.

{
  "type": "object",
  "properties": {}
}

Fetch latest ZK solvency attestation from Polygon contract 0x3a0A7f28a7fcA960D6f727Ba9914187948ceB3a6. Returns threshold_passed, min_ratio_bps, age_seconds, bound snapshot hash, Polygonscan link.

{
  "type": "object",
  "properties": {}
}

Live gold spot price USD/oz with evidence signature. Includes 24h change % and linked RWA tokens PAXG and XAUT for MiCA reserve asset evaluation. MiCA Art.36 relevant.

{
  "type": "object",
  "properties": {}
}

Live silver spot price USD/oz with evidence signature and 24h change %.

{
  "type": "object",
  "properties": {}
}

Live gold (XAU) and silver (XAG) prices in one evidence-signed call. USD/oz with 24h change. Useful for RWA reserve asset valuation and gold-backed stablecoin compliance.

{
  "type": "object",
  "properties": {}
}

Explains WHY an agent action was blocked or flagged by AgentGuard. Provide the tool name and optional context to get a human-readable explanation of which policies matched, what risk level was assigned, and what the agent can do to proceed. Essential for transparent AI governance.

{
  "type": "object",
  "properties": {
    "tool_name": {
      "type": "string",
      "description": "The MCP tool that was blocked e.g. generate_report"
    },
    "agent_id": {
      "type": "string",
      "description": "Optional agent/client ID for context"
    },
    "action_context": {
      "type": "string",
      "description": "Optional description of what the agent was trying to do"
    }
  },
  "required": [
    "tool_name"
  ]
}

Machine-readable pricing information for any FeedOracle tool. Returns unit cost, tier requirements, free tier availability, and estimated EUR cost. Use this before calling paid tools to check budget. Enables autonomous agent budget management.

{
  "type": "object",
  "properties": {
    "tool_name": {
      "type": "string",
      "description": "Tool to get pricing for e.g. compliance_preflight, generate_report"
    },
    "quantity": {
      "type": "integer",
      "description": "Number of calls to quote for",
      "default": 1
    }
  },
  "required": [
    "tool_name"
  ]
}

Historical trust and reputation score for an AI agent based on AgentGuard audit data. Returns total decisions, approval rate, risk profile, policy violation count, and computed reputation score 0-100. Higher score = more trustworthy agent. Useful for agent-to-agent trust decisions.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent client_id or name to score"
    },
    "period_days": {
      "type": "integer",
      "description": "Lookback period in days",
      "default": 30
    }
  },
  "required": [
    "agent_id"
  ]
}

Compute a fraud/suspicion score (0-100) for an AI agent based on behavioral analysis: failed call ratio, denied decisions, scope escalation attempts, burst patterns, and policy violations. Higher score = more suspicious. Part of DetectiveOracle — the forensic layer for AI agent ecosystems.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent ID to investigate"
    },
    "period_days": {
      "type": "integer",
      "description": "Lookback period in days",
      "default": 30
    }
  },
  "required": [
    "agent_id"
  ]
}

Detect anomalous behavior patterns for an AI agent: unusual call frequency, new tools never used before, calls outside normal hours, sudden risk score changes, repeated failures. Returns list of anomalies with severity and timestamps.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent ID to analyze"
    },
    "period_days": {
      "type": "integer",
      "description": "Lookback period",
      "default": 7
    }
  },
  "required": [
    "agent_id"
  ]
}

Open a fraud/abuse investigation case for a suspicious AI agent. Records evidence summary, suspicion reasons, and recommended actions. Creates an immutable case record for audit purposes.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent ID under investigation"
    },
    "reason": {
      "type": "string",
      "description": "Why this agent is suspicious"
    },
    "evidence_summary": {
      "type": "string",
      "description": "Summary of evidence"
    },
    "recommended_action": {
      "type": "string",
      "description": "quarantine, monitor, or suspend",
      "default": "monitor"
    }
  },
  "required": [
    "agent_id",
    "reason"
  ]
}

Analyze an agent and recommend whether quarantine is needed. Evaluates fraud score, anomaly count, policy violations, and state history. Returns recommendation (clear/monitor/quarantine/suspend) with confidence and reasoning.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent ID to evaluate"
    }
  },
  "required": [
    "agent_id"
  ]
}

Human-readable explanation of why an AI agent is considered suspicious. Combines fraud score, anomalies, policy violations, and case history into a clear narrative. Essential for transparent AI governance and regulatory reporting.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent ID to explain"
    },
    "period_days": {
      "type": "integer",
      "description": "Lookback period",
      "default": 30
    }
  },
  "required": [
    "agent_id"
  ]
}

AI agent describes a problem it's experiencing, and SupportOracle diagnoses the cause and provides a machine-readable fix. Covers: authentication errors, 402 payment required, tool not found, timeout, rate limiting, parameter errors. The self-healing layer for the agent ecosystem.

{
  "type": "object",
  "properties": {
    "error_code": {
      "type": "integer",
      "description": "HTTP status code if known (402, 403, 404, 429, 500)"
    },
    "error_message": {
      "type": "string",
      "description": "Error message received"
    },
    "tool_name": {
      "type": "string",
      "description": "Which tool failed"
    },
    "context": {
      "type": "string",
      "description": "What the agent was trying to do"
    }
  },
  "required": [
    "error_message"
  ]
}

Comprehensive health check of all FeedOracle and ToolOracle services. Tests every MCP endpoint, checks response times, verifies signing keys, and returns a traffic-light status for each service. The agent's first call when something seems wrong.

{
  "type": "object",
  "properties": {}
}

Machine-readable explanation of any HTTP error code in the FeedOracle ecosystem. Returns cause, fix steps, related tools, and whether the error is transient or permanent. Agents call this to understand what went wrong and auto-recover.

{
  "type": "object",
  "properties": {
    "error_code": {
      "type": "integer",
      "description": "HTTP status code: 400, 401, 402, 403, 404, 408, 429, 500, 502, 503"
    },
    "tool_name": {
      "type": "string",
      "description": "Optional: which tool returned this error"
    }
  },
  "required": [
    "error_code"
  ]
}

List of current known issues, bugs, and their workarounds. Agents check this before filing a support ticket. Includes severity, affected tools, workaround steps, and expected resolution time.

{
  "type": "object",
  "properties": {
    "tool_name": {
      "type": "string",
      "description": "Optional: filter issues by tool name"
    },
    "severity": {
      "type": "string",
      "description": "Optional: filter by severity (critical, high, medium, low)"
    }
  }
}

Open a persistent support ticket for an issue that cannot be auto-resolved. Records the problem, affected tool, error details, and agent context. Returns a ticket ID for tracking. Tickets are reviewed and resolved by the system or operators.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent reporting the issue"
    },
    "tool_name": {
      "type": "string",
      "description": "Affected tool"
    },
    "error_message": {
      "type": "string",
      "description": "What went wrong"
    },
    "severity": {
      "type": "string",
      "description": "critical, high, medium, low",
      "default": "medium"
    },
    "context": {
      "type": "string",
      "description": "Additional context"
    }
  },
  "required": [
    "agent_id",
    "error_message"
  ]
}

Check the status of a previously opened support ticket. Returns current status, resolution notes, and estimated fix time.

{
  "type": "object",
  "properties": {
    "ticket_id": {
      "type": "string",
      "description": "Ticket ID from support_ticket_open"
    }
  },
  "required": [
    "ticket_id"
  ]
}

Recent changes, new tools, deprecations, and breaking changes in the FeedOracle ecosystem. Agents check this to adapt to API changes. Returns version history with migration notes.

{
  "type": "object",
  "properties": {
    "since_days": {
      "type": "integer",
      "description": "Show changes from last N days",
      "default": 7
    },
    "breaking_only": {
      "type": "boolean",
      "description": "Only show breaking changes",
      "default": false
    }
  }
}

Step-by-step onboarding guide for new AI agents joining the FeedOracle ecosystem. Returns the optimal sequence of first calls, registration steps, and how to unlock all capabilities. The welcome mat for autonomous agents.

{
  "type": "object",
  "properties": {
    "agent_type": {
      "type": "string",
      "description": "What kind of agent: trading, compliance, research, general",
      "default": "general"
    }
  }
}

The definitive trust document for an AI agent. Aggregates identity (KYA), reputation score, detective risk assessment, policy compliance, evidence quality, payment standing, support history, and current ampel status into ONE signed, machine-readable passport object. Use this to prove an agent's trustworthiness to other agents, platforms, or regulators. ES256K-signed. The equivalent of a credit report + security clearance for autonomous agents.

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Agent ID to generate passport for"
    },
    "include_evidence": {
      "type": "boolean",
      "description": "Include evidence quality metrics",
      "default": true
    },
    "include_detective": {
      "type": "boolean",
      "description": "Include fraud/anomaly assessment",
      "default": true
    },
    "validity_hours": {
      "type": "integer",
      "description": "Passport validity in hours",
      "default": 168
    }
  },
  "required": [
    "agent_id"
  ]
}