MCP Servers

Model Context Protocol (MCP) servers extend your agent's capabilities with external tools and resources.

Overview

MCP enables:

• Tool discovery and execution
• Resource access
• Context sharing
• Standardized integration

What is MCP?

The Model Context Protocol is an open standard for:

• Connecting AI to external systems
• Exposing tools and resources
• Stateless tool discovery
• Cross-platform compatibility

Adding MCP Servers

Via Dashboard

1. Navigate to MCP
2. Click Add Server
3. Enter server details:
   • Name
   • URL
   • Authentication
4. Click Connect

Via API

curl -X POST https://your-domain.com/api/agents/{id}/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GitHub Tools",
    "url": "https://mcp.github.com/v1",
    "auth": {
      "type": "bearer",
      "token": "{{secrets.github_token}}"
    }
  }'

Server Configuration

Basic Server

{
  "name": "Database Tools",
  "url": "https://mcp.example.com",
  "description": "Database operations"
}

Authenticated Server

{
  "name": "Secure API",
  "url": "https://mcp.secure.com",
  "auth": {
    "type": "bearer",
    "token": "secret-token"
  }
}

Headers

{
  "name": "Custom Server",
  "url": "https://mcp.custom.com",
  "headers": {
    "X-API-Key": "key123",
    "X-Tenant": "tenant-1"
  }
}

Tool Discovery

MCP servers expose tools dynamically:

┌─────────────────┐     ┌─────────────────┐
│   Uranus Agent  │────▶│   MCP Server    │
│                 │     │                 │
│   "List tools"  │     │   Returns:      │
│                 │◀────│   - search_db   │
│                 │     │   - create_user │
│                 │     │   - send_email  │
└─────────────────┘     └─────────────────┘

Get Available Tools

curl https://your-domain.com/api/agents/{id}/mcp/{serverId}/tools

Response:

{
  "tools": [
    {
      "name": "search_database",
      "description": "Search the database",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Search query"
          },
          "limit": {
            "type": "number",
            "default": 10
          }
        },
        "required": ["query"]
      }
    }
  ]
}

Using MCP Tools

In Chat

MCP tools are automatically available:

User: "Search the database for recent orders"

Agent: [Calls search_database tool via MCP]
       → Returns results

In Workflows

{
  "type": "mcp-tool",
  "data": {
    "server": "database-tools",
    "tool": "search_database",
    "args": {
      "query": "{{input.search_term}}",
      "limit": 20
    }
  }
}

Managing Servers

List Servers

curl https://your-domain.com/api/agents/{id}/mcp

Get Server Status

curl https://your-domain.com/api/agents/{id}/mcp/{serverId}

Delete Server

curl -X DELETE "https://your-domain.com/api/agents/{id}/mcp?id={serverId}"

Server Status

Status	Description
connected	Server is accessible
disconnected	Connection failed
error	Server returned error
pending	Connection in progress

Authentication Types

Bearer Token

{
  "auth": {
    "type": "bearer",
    "token": "your-api-token"
  }
}

API Key

{
  "auth": {
    "type": "api-key",
    "key": "X-API-Key",
    "value": "your-api-key"
  }
}

OAuth

{
  "auth": {
    "type": "oauth",
    "client_id": "...",
    "client_secret": "...",
    "token_url": "https://..."
  }
}

Common MCP Servers

Database Operations

• Query execution
• Schema inspection
• Data manipulation

File Systems

• Read/write files
• Directory listing
• File search

Web Services

• HTTP requests
• Web scraping
• API integration

Code Execution

• Run scripts
• Evaluate expressions
• Execute commands

Building MCP Servers

Create custom MCP servers:

import { MCPServer } from 'mcp-sdk'

const server = new MCPServer({
  name: 'My Tools',
  version: '1.0.0'
})

server.addTool({
  name: 'my_tool',
  description: 'Does something useful',
  parameters: {
    type: 'object',
    properties: {
      input: { type: 'string' }
    }
  },
  handler: async ({ input }) => {
    return { result: `Processed: ${input}` }
  }
})

server.start()

Best Practices

1. Use Descriptive Names

Name servers clearly:

• github-tools not server1
• database-ops not mcp-2

2. Secure Credentials

Protect authentication:

• Use secrets storage
• Rotate tokens regularly
• Limit permissions

3. Monitor Status

Track server health:

• Check connectivity
• Monitor latency
• Alert on failures

4. Document Tools

Describe tools clearly:

• Purpose
• Parameters
• Examples
• Limitations

5. Handle Errors

Implement graceful failures:

• Retry logic
• Fallback behavior
• Error logging

Troubleshooting

Connection Failed

1. Verify server URL
2. Check authentication
3. Test network connectivity
4. Review server logs

Tools Not Loading

1. Refresh tool list
2. Check server version
3. Verify protocol compatibility
4. Review error messages

Slow Response

1. Check server latency
2. Monitor timeout settings
3. Consider caching
4. Optimize queries

API Reference

See MCP API for complete endpoint documentation.