MCP Tools Integration

The Model Context Protocol (MCP) enables AI agents to interact with external tools and services. Build intelligent automation for residential AI and smart home applications.

What is MCP?

MCP is an open protocol that allows AI models to safely access external tools, data sources, and services. Rather than hardcoding integrations, MCP provides a standardized way for agents to discover and use capabilities dynamically.

Key Benefits

• Extensible: Add new tools without modifying agent code
• Secure: Tools run in isolated contexts with defined permissions
• Discoverable: Agents can query available tools and their schemas
• Standardized: One protocol works across different AI providers

Industry Focus: Residential AI

Aethyr's MCP implementation is optimized for residential AI and luxury home remodeling applications. Connect AI agents to smart home systems, project management tools, and design services.

Smart Home Integration

Lighting and climate control
Security system management
Energy monitoring
Voice assistant bridges

Luxury Remodeling

Project timeline management
Vendor coordination
Material sourcing
Design visualization

Available Tool Categories

Scheduling & Calendar

Manage appointments and timelines

{
  "name": "schedule_appointment",
  "description": "Schedule a contractor visit or consultation",
  "parameters": {
    "type": "object",
    "properties": {
      "title": { "type": "string" },
      "datetime": { "type": "string", "format": "date-time" },
      "attendees": { "type": "array", "items": { "type": "string" } }
    }
  }
}

Document Management

Handle contracts, permits, and specs

{
  "name": "search_documents",
  "description": "Search project documents and specifications",
  "parameters": {
    "type": "object",
    "properties": {
      "query": { "type": "string" },
      "documentType": { 
        "type": "string",
        "enum": ["contract", "permit", "specification", "invoice"]
      }
    }
  }
}

Communication

Client and vendor messaging

{
  "name": "send_notification",
  "description": "Send project updates to stakeholders",
  "parameters": {
    "type": "object",
    "properties": {
      "recipients": { "type": "array", "items": { "type": "string" } },
      "message": { "type": "string" },
      "priority": { "type": "string", "enum": ["low", "normal", "high"] }
    }
  }
}

Creating Custom Tools

Extend Aethyr with custom MCP tools tailored to your specific workflows.

custom-tool.ts

import { MCPTool, ToolContext } from '@aethyr/mcp';

export const quoteCalculator: MCPTool = {
  name: 'calculate_project_quote',
  description: 'Calculate cost estimate for remodeling project',
  parameters: {
    type: 'object',
    properties: {
      roomType: {
        type: 'string',
        enum: ['kitchen', 'bathroom', 'bedroom', 'living'],
        description: 'Type of room being remodeled'
      },
      squareFootage: {
        type: 'number',
        description: 'Room size in square feet'
      },
      finishLevel: {
        type: 'string',
        enum: ['standard', 'premium', 'luxury'],
        description: 'Quality tier of finishes'
      }
    },
    required: ['roomType', 'squareFootage', 'finishLevel']
  },
  
  async execute(params: any, context: ToolContext) {
    const rates = {
      kitchen: { standard: 150, premium: 250, luxury: 400 },
      bathroom: { standard: 175, premium: 300, luxury: 500 },
      bedroom: { standard: 75, premium: 125, luxury: 200 },
      living: { standard: 100, premium: 175, luxury: 275 }
    };
    
    const rate = rates[params.roomType][params.finishLevel];
    const estimate = params.squareFootage * rate;
    
    return {
      estimate,
      breakdown: {
        labor: estimate * 0.4,
        materials: estimate * 0.5,
        overhead: estimate * 0.1
      },
      validUntil: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000)
    };
  }
};

Tool Configuration

Configure which tools are available to each agent and set permission boundaries.

Agent Tool Configuration

// Agent configuration
{
  "agentId": "project-coordinator",
  "tools": {
    "enabled": [
      "schedule_appointment",
      "search_documents",
      "send_notification",
      "calculate_project_quote"
    ],
    "permissions": {
      "schedule_appointment": {
        "maxAttendeesPerEvent": 10,
        "allowRecurring": true
      },
      "send_notification": {
        "allowExternalRecipients": false,
        "maxRecipientsPerMessage": 50
      }
    }
  }
}

Previous: Security Back to Docs Home