> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evo-ai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Configure MCP (Model Context Protocol) servers to extend your agents capabilities

## Overview

The **MCP Server** (Model Context Protocol) allows you to connect your agents to external servers that provide additional tools and functionalities. **Evo AI provides a complete library** of pre-configured MCP servers, allowing you to expand your agents' capabilities with:

* **External APIs** and web services
* **Databases** and storage systems
* **Specialized tools** for specific tasks
* **System resources** local or remote

<Note>
  **Evo AI Library**: MCP servers are provided and maintained by Evo AI.
  You only need to configure the necessary variables and select the desired tools.
</Note>

## How to Configure an MCP Server

### Step 1: Access Agent Settings

<AccordionGroup>
  <Accordion icon="gear" title="Navigate to settings">
    1. Go to the **agents screen** in the dashboard
    2. Locate the agent you want to configure
    3. Click on the **"Settings"** icon (⚙️) on the agent card and then on **"Edit"**
    4. You will be directed to the agent settings screen
  </Accordion>

  <Accordion icon="server" title="Access MCP Servers">
    1. In the settings screen, locate the **"MCP Servers"** section
    2. Click **"Add"** to add a new MCP server

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/mcp_server01_option.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=d3e52aaa66f71d1bec66599dd219b1e9" alt="Option to Add MCP Server" width="1148" height="372" data-path="images/prints/mcp_server01_option.png" />

    <Info>
      Each agent can have multiple MCP servers configured simultaneously.
    </Info>
  </Accordion>
</AccordionGroup>

### Step 2: Select MCP Server

<AccordionGroup>
  <Accordion icon="list" title="Choose from Evo AI library">
    1. A **library of MCP servers** maintained by Evo AI will be displayed
    2. Browse through the list and select the server that meets your needs
    3. Each server has a description of the functionalities it offers
    4. **All servers are pre-tested** and maintained by the Evo AI team

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/mcp_server02_select.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=2581ca73fb39553c419935e0f5c6255e" alt="Evo AI MCP Servers Library" width="1101" height="756" data-path="images/prints/mcp_server02_select.png" />

    <Info>
      **Curated Library**: All MCP servers are selected, tested, and maintained by Evo AI to ensure quality and reliability.
    </Info>
  </Accordion>
</AccordionGroup>

### Step 3: Configure Variables and Tools

<AccordionGroup>
  <Accordion icon="gear" title="Configure server variables">
    1. After selecting the server from the library, you will see the **configuration screen**
    2. Fill in only the **necessary variables** (such as API keys, URLs, credentials)
    3. **No need to configure the server** - it's already ready to use
    4. Evo AI takes care of all infrastructure and maintenance

    <img src="https://mintcdn.com/evoai/aegF-STVJ9LMQ4Va/images/prints/mcp_server03_condif_server.png?fit=max&auto=format&n=aegF-STVJ9LMQ4Va&q=85&s=00b66ab68c8e357d2688f4c2b2c5809b" alt="Simple MCP Server Configuration" width="1069" height="1170" data-path="images/prints/mcp_server03_condif_server.png" />

    <Tip>
      You only need to provide your specific credentials. Everything else is already configured by Evo AI.
    </Tip>
  </Accordion>

  <Accordion icon="wrench" title="Select available tools">
    **On the same configuration screen:**

    1. **View the tools** already available from the server
    2. **Check the tools** that your agent will use
    3. **Configure specific parameters** only if necessary
    4. **Test connectivity** before saving

    **Advantages of the Evo AI library:**

    * 🔍 **Pre-tested tools** and optimized
    * 📊 **Integrated documentation** for each tool
    * 🌐 **Automatic updates** without intervention
    * 📁 **Technical support** from the Evo AI team
    * 🔧 **Optimized performance** for the platform
  </Accordion>

  <Accordion icon="check" title="Save configuration">
    1. **Review your settings** (only variables and selected tools)
    2. **Test the connection** - Evo AI validates automatically
    3. Click **"Save"** to apply the settings
    4. The server will be **immediately available** for the agent

    <Info>
      The server infrastructure is managed by Evo AI. You only configure what you need to use.
    </Info>
  </Accordion>
</AccordionGroup>

## Evo AI Server Library

### Available Servers

<AccordionGroup>
  <Accordion icon="magnifying-glass" title="Search and Research">
    **Brave Search** - Integration with the Brave search engine. Enables general and local web searches, providing updated and relevant information.

    **Google Search** - Web search capabilities using Google Custom Search API and web page content extraction functionality.

    **Perplexity Ask** - Integration with Sonar API for real-time search, providing AI assistants with unprecedented web search capabilities.

    **OpenAI WebSearch** - Access to OpenAI's web search functionality, allowing AI assistants to search the web during conversations.

    **Tavily** - MCP server offering intelligent web search, content extraction, and structured website tracking with advanced AI capabilities.
  </Accordion>

  <Accordion icon="code" title="Development and DevOps">
    **Github** - Complete integration with GitHub APIs, enabling advanced automation and interaction capabilities for developers.

    **Gitlab** - MCP server for GitLab API, enabling project management, file operations, and much more.

    **Calculator** - Server for precise mathematical calculations, allowing LLMs to perform advanced numerical operations.

    **Uptime Kuma** - Server for managing Uptime Kuma monitors, enabling service availability monitoring.

    **Whois** - Allows AI agents to perform WHOIS queries and retrieve domain details, checking availability and ownership.
  </Accordion>

  <Accordion icon="building" title="CRM and Productivity">
    **Hubspot** - Complete integration with HubSpot CRM, allowing AI assistants to execute actions and interact with HubSpot data.

    **ClickUp** - Complete integration with ClickUp for task management, projects, spaces, lists, and folders through standardized protocol.

    **Notion** - Official Notion MCP server for complete integration with workspaces, pages, databases, and blocks.

    **Slack** - Integration with Slack Workspaces, supporting multiple transports without need for admin-approved permissions or bots.
  </Accordion>

  <Accordion icon="globe" title="Web Scraping and Extraction">
    **Firecrawl** - MCP implementation that integrates with Firecrawl for advanced web scraping capabilities with JS rendering and content extraction.

    **Sequential Thinking** - Tool for dynamic and reflective problem solving through structured thinking process.
  </Accordion>

  <Accordion icon="chart-line" title="Data and Analytics">
    **Yahoo Finance** - Server for interacting with Yahoo Finance, providing access to prices, company information, and financial data.

    **Pinecone Developer** - Allows coding assistants to connect with Pinecone projects and documentation for index configuration and vector search.
  </Accordion>

  <Accordion icon="plane" title="Travel and Accommodation">
    **Airbnb** - Server for searching Airbnb listings and getting accommodation details for travel planning.

    **Travel Planner** - MCP implementation for interacting with Google Maps and travel planning services, including location search and time calculations.
  </Accordion>

  <Accordion icon="image" title="Media and Content">
    **Image Generation** - Server offering image generation capabilities using the Replicate Flux model.
  </Accordion>
</AccordionGroup>

### How to Use the Servers

<AccordionGroup>
  <Accordion icon="rocket" title="Simplified configuration">
    **Benefits:**

    * 🚀 **Instant setup** - Ready-to-use servers
    * 🔧 **Minimal configuration** - Only your API credentials
    * 📚 **Integrated documentation** - Guides within the platform
    * ✅ **Automatic testing** - Connectivity validation

    <Info>
      Each server requires only specific environment variables (like API\_KEY). Evo AI takes care of all infrastructure.
    </Info>
  </Accordion>

  <Accordion icon="shield" title="Guaranteed reliability">
    **Assured quality:**

    * 🔒 **Validated security** - All servers are audited
    * 🔄 **Automatic updates** - Always on the latest version
    * 📊 **24/7 monitoring** - Guaranteed availability
    * 🛠️ **Technical support** - Specialized team available

    <Tip>
      The library is constantly updated with new servers and improvements.
    </Tip>
  </Accordion>
</AccordionGroup>

## Common MCP Server Types

### Data Servers

<AccordionGroup>
  <Accordion icon="database" title="Databases">
    **Typical functionalities:**

    * Real-time SQL queries
    * Data insertion and updates
    * Reports and analysis
    * Backup and synchronization

    **Common variables:**

    * `DATABASE_URL`: Connection URL
    * `USERNAME`: Database user
    * `PASSWORD`: Access password
    * `SCHEMA`: Specific schema
  </Accordion>

  <Accordion icon="cloud" title="Third-party APIs">
    **Integration examples:**

    * CRM (Salesforce, HubSpot)
    * E-commerce (Shopify, WooCommerce)
    * Communication (Slack, Discord)
    * Productivity (Google Workspace, Microsoft 365)

    **Typical configurations:**

    * `API_KEY`: API access key
    * `BASE_URL`: Service base URL
    * `RATE_LIMIT`: Request limit
    * `TIMEOUT`: Request timeout
  </Accordion>
</AccordionGroup>

### Tool Servers

<AccordionGroup>
  <Accordion icon="calculator" title="Processing and calculations">
    **Capabilities:**

    * Complex mathematical calculations
    * Statistical data processing
    * Financial analysis
    * Unit conversions

    **Available tools:**

    * `calculate`: Mathematical operations
    * `analyze_data`: Statistical analysis
    * `convert_units`: Unit conversions
    * `financial_calc`: Financial calculations
  </Accordion>

  <Accordion icon="file" title="File manipulation">
    **Functionalities:**

    * Reading and writing files
    * Format conversion
    * Image processing
    * Document analysis

    **Typical tools:**

    * `read_file`: Read file content
    * `write_file`: Create/edit files
    * `convert_format`: Convert formats
    * `extract_text`: Extract text from documents
  </Accordion>
</AccordionGroup>

## Advanced Use Cases

### Multi-Server Integration

<AccordionGroup>
  <Accordion icon="sitemap" title="Complex workflows">
    **Scenarios:**

    * Agent that queries CRM + database + payment API
    * Data processing involving multiple sources
    * Automation integrating different business systems

    **Configuration:**

    1. Configure multiple MCP servers on the same agent
    2. Define tool execution order
    3. Configure fallbacks for failure scenarios
    4. Monitor complete workflow performance
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Common issues">
    **MCP server won't connect:**

    * Check if credentials are correct
    * Confirm the server is online and accessible
    * Test network connectivity
    * Check error logs in the dashboard

    **Tools don't work:**

    * Confirm tools were selected correctly
    * Check access permissions on external server
    * Test each tool individually
    * Consult specific MCP server documentation

    **Slow performance:**

    * Check network latency to the server
    * Optimize timeout parameters
    * Consider using cache when possible
    * Monitor external API rate limits

    **Authentication errors:**

    * Regenerate API keys if necessary
    * Check if credentials haven't expired
    * Confirm permissions in external system
    * Test authentication directly on the API
  </Accordion>
</AccordionGroup>

***

🔧 **Configuration complete!** Your agents now have access to tools and external resources through the MCP protocol. Explore the possibilities and create even more powerful experiences!