> ## Documentation Index
> Fetch the complete documentation index at: https://ixoworld-mintlify-9a7944b6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Servers

> Model Context Protocol (MCP) servers for the IXO ecosystem

Model Context Protocol (MCP) servers enable Large Language Model (LLM) agents to safely interact with IXO ecosystem services through specialized server interfaces.

<CardGroup cols={2}>
  <Card title="Secure Access" icon="shield-check">
    Controlled access to IXO services with robust security mechanisms
  </Card>

  <Card title="Standardized APIs" icon="code">
    Consistent API patterns across all MCP server types
  </Card>
</CardGroup>

## Architecture Overview

<Frame>
  <img src="https://mintcdn.com/ixoworld-mintlify-9a7944b6/Bf8UwiG16OxMTFXM/images/emerging.svg?fit=max&auto=format&n=Bf8UwiG16OxMTFXM&q=85&s=cf5a36a90e890ed99a788c187aca7444" alt="MCP server integration overview" width="1920" height="1080" data-path="images/emerging.svg" />
</Frame>

MCP servers act as secure gateways between AI agents and IXO services:

<CardGroup cols={3}>
  <Card title="Blockchain" icon="cube">
    Access on-chain data and transactions via MultiClient SDK
  </Card>

  <Card title="Matrix" icon="network-wired">
    Secure communication within decentralized messaging infrastructure
  </Card>

  <Card title="Applications" icon="window">
    Integration with user-facing applications like IXO Portal
  </Card>
</CardGroup>

## Security Model

Each MCP server implements three core security components:

<Steps>
  <Step title="Decentralized Identity (DID)">
    Secure, blockchain-verified agent identities
  </Step>

  <Step title="UCAN Tokens">
    User Controlled Authorization Network credentials for authentication
  </Step>

  <Step title="Capability Based Access Control">
    Fine-grained permissions for resource access
  </Step>
</Steps>

## Available Servers

<Tabs>
  <Tab title="Blockchain MCP Server">
    Access IXO blockchain functionality:

    * Query on-chain data and entity states
    * Submit authorized transactions
    * Monitor blockchain events
    * Access MultiClient SDK features

    <CodeGroup>
      ```typescript Example Query theme={null}
      const client = new BlockchainMCP({
        endpoint: "https://mcp.ixo.earth/blockchain"
      });

      // Query entity state
      const entity = await client.getEntity(entityId);
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Matrix MCP Server">
    Enable secure, decentralized communication:

    * Manage encrypted rooms
    * Send/receive messages
    * Access federated storage
    * Handle real-time events
  </Tab>

  <Tab title="Agentic Oracles MCP Server">
    Interact with Impact Oracle services:

    * Submit verification data
    * Access verification results
    * Query measurements
    * Participate in consensus
  </Tab>

  <Tab title="Client MCP Server">
    Integrate with user applications:

    * Access app state
    * Handle user interactions
    * Manage UI updates
    * Process app events
  </Tab>

  <Tab title="Personal Agent MCP Server">
    Provide AI support services:

    * Handle user queries
    * Access knowledge bases
    * Manage support flows
    * Coordinate with agents
  </Tab>
</Tabs>

## Integration Guides

<CardGroup cols={2}>
  <Card title="Blockchain Integration" icon="cube" href="/guides/dev/authentication">
    Connect AI agents to the IXO blockchain
  </Card>

  <Card title="Matrix Integration" icon="network-wired" href="/sdk-reference/matrix-client-sdk">
    Enable secure agent communication
  </Card>

  <Card title="Personal Agent ADK" icon="crystal-ball" href="/sdk-reference/oracle-adk">
    Access Impact Oracle services
  </Card>

  <Card title="Client Integration" icon="window" href="/sdk-reference/multiclient-sdk">
    Integrate with IXO applications
  </Card>
</CardGroup>

<Tip>
  For service auth and endpoint ownership, use the [Authentication Matrix](/reference/authentication-matrix) and [Networks and Endpoints](/reference/networks-and-endpoints).
</Tip>