MCP Agentic RAG System
UnyKorn integrates AI capabilities through a Model Context Protocol server exposing full network operations as structured tools, a Retrieval-Augmented Generation knowledge system, and autonomous agent workflows for monitoring, compliance, and operational intelligence.
Three-Layer AI Infrastructure
MCP Server
Model Context Protocol server exposing UnyKorn's full API surface as structured, discoverable tools with parameter validation and execution sandboxing.
RAG Knowledge System
Retrieval-Augmented Generation system indexing the complete codebase, documentation, transaction history, and network metrics for factually grounded AI responses.
Agentic Workflows
Autonomous multi-step agent pipelines for bridge monitoring, compliance reporting, validator auditing, and trade finance tracking with full audit trails.
Tool Registry
The MCP server exposes 22 structured tools across 5 categories. Each tool includes full JSON Schema parameter definitions, execution sandboxing, and authorization scope enforcement.
Network State
get_blockRetrieve block by height or hash
get_transactionQuery transaction by ID with full receipt
get_accountAccount balance, nonce, and DID resolution
get_validator_setCurrent validator set with class and stake
get_mempool_statsPending transaction count and fee distribution
Transaction Composition
compose_transferBuild UNY or token transfer transaction
compose_lc_operationLetter of Credit lifecycle operation
compose_bridge_transferCross-chain XRPL bridge transaction
compose_custody_operationFireblocks/BitGo custody action
compose_governance_voteOn-chain governance proposal vote
Compliance & Policy
evaluate_policyPre-check transaction against policy rules
get_kyc_statusDID credential verification status
get_compliance_reportGenerate jurisdiction-specific report
list_policy_rulesActive policy rule sets per jurisdiction
Bridge & Custody
get_bridge_statusXRPL bridge health and transfer stats
get_escrow_statusActive escrow conditions and expirations
get_custody_positionsCross-provider position summary
get_funding_routesOptimal routing options for a transfer
Monitoring & Analytics
get_network_metricsPrometheus-compatible performance metrics
get_validator_performanceUptime, blocks produced, slashing events
get_bridge_analyticsTransfer volume, latency, circuit breaker state
generate_audit_trailExport regulatory audit data for date range
Knowledge Sources
The RAG system indexes four primary knowledge domains, enabling AI responses grounded in verified network data rather than generic training data.
Codebase Knowledge
Complete 37-crate Rust workspace indexed with structural understanding of module boundaries, trait interfaces, and dependency graphs.
Documentation Index
Whitepaper, research papers, API documentation, and operational runbooks indexed for semantic retrieval.
Transaction History
Historical transaction data, block production records, and validator activity logs available for analytical queries.
Network Metrics
Real-time and historical Prometheus metrics for performance monitoring, anomaly detection, and capacity planning.
Agentic Workflows
Pre-configured agent pipelines that combine MCP tools and RAG knowledge to execute multi-step operational workflows autonomously, with full authorization enforcement and audit logging.
Bridge Health Monitor
Continuous (30-second intervals)Continuously monitors XRPL bridge transfer patterns, validates threshold signatures, and triggers circuit breaker alerts when anomalous activity is detected.
Compliance Report Generator
Scheduled (daily/weekly) or on-demandAutomated generation of jurisdiction-specific regulatory reports by querying transaction history, policy evaluation results, and KYC/AML verification records.
Validator Performance Auditor
Continuous with hourly aggregationAnalyzes validator uptime, block production rates, and policy quorum participation to identify underperforming validators and potential slashing events.
Trade Finance Status Tracker
Event-driven (LC state transitions)Monitors active Letters of Credit through their lifecycle, providing real-time status updates to participating parties and alerting on document examination deadlines.
AI Authorization Framework
Execution Sandboxing
All MCP tool executions run within isolated sandboxes with resource limits on computation time, memory allocation, and network I/O. State-modifying operations require explicit authorization tokens scoped to specific tool categories and parameter ranges.
Role-Based Access Control
Agent permissions are bound to DID-verified operator credentials. Read-only operations (queries, metrics) require standard authentication. Write operations (transactions, configuration) require elevated authorization tied to the operator's validator class and institutional role.
Audit Trail
Every AI agent action — tool invocation, RAG query, workflow step execution — is recorded in an immutable audit log with operator identity, timestamp, parameters, and results. Audit data supports regulatory examination requirements across all supported jurisdictions.
Rate Limiting & Circuit Breakers
Agent operations are subject to configurable rate limits per operator, per tool category, and per time window. Circuit breakers automatically disable agent access to sensitive operations (bridge transfers, custody actions) when anomalous invocation patterns are detected.
Integrate with UnyKorn AI
Access the MCP server and RAG knowledge system for institutional AI integration. Documentation and API keys available to registered participants.