MCP Integration

npm install @buena/sdk

You: "Show me all leads from technology companies"

AI Assistant uses: buena_list_leads(company="technology", limit=20)

Result: Lists leads with company names containing "technology"

You: "Add John Smith from Acme Corp as a new lead. His email is [email protected] and he's a Software Engineer"

AI Assistant uses: buena_create_lead(
  first_name="John",
  last_name="Smith",
  email="[email protected]",
  company="Acme Corp",
  job_title="Software Engineer"
)

Result: Creates the lead and returns the new lead ID

You: "Find all leads who work at startups and haven't been contacted yet"

AI Assistant uses: buena_list_leads(
  search="startup",
  status="inactive",
  limit=50
)

Result: Returns uncontacted leads from startup companies

You: "Create a voice clone called 'Professional Voice' and send a voice message to John Smith on LinkedIn"

AI Assistant:
1. Uses buena_create_voice_clone(name="Professional Voice", audio_files=[...])
2. Uses buena_send_linkedin_voice_message(
     profile_url="https://linkedin.com/in/johnsmith",
     message="Hi John, hope you're well!",
     voice_settings={
       "voice_id": "new-voice-id",
       "voice_text": "Hi John, hope you're having a great week!"
     }
   )

Result: Creates voice clone and sends personalized voice message

You: "Generate a preview of my voice clone saying 'Hello, this is a test message'"

AI Assistant uses: buena_generate_voice_preview(
  voice_id="user-voice-id",
  text="Hello, this is a test message"
)

Result: Returns audio preview URL for testing voice quality

You: "Help me qualify leads from last week. Show me new leads and analyze their potential"

AI Assistant:
1. Uses buena_list_leads(sort="created_at", order="desc") to get recent leads
2. Analyzes each lead's company, title, and notes
3. Provides qualification recommendations
4. Optionally updates lead status using buena_update_lead()

You: "Find and clean up duplicate leads based on email addresses"

AI Assistant:
1. Uses buena_list_leads() to get all leads
2. Identifies duplicates by email
3. Suggests which duplicates to keep/remove
4. Uses buena_delete_lead() to remove confirmed duplicates

{
  "server": {
    "port": 3001,
    "logLevel": "info"
  },
  "api": {
    "baseUrl": "https://api.buena.ai/api/v2",
    "timeout": 30000,
    "retries": 3
  },
  "tools": {
    "enabled": [
      "buena_list_leads",
      "buena_create_lead",
      "buena_get_lead",
      "buena_update_lead",
      "buena_delete_lead",
      "buena_list_api_keys",
      "buena_create_api_key",
      "buena_list_voice_clones",
      "buena_create_voice_clone",
      "buena_update_voice_clone",
      "buena_delete_voice_clone",
      "buena_generate_voice_preview",
      "buena_send_linkedin_voice_message",
      "buena_health_check"
    ],
    "limits": {
      "maxLeadsPerQuery": 100,
      "maxBatchSize": 50
    }
  }
}

// test-mcp-integration.js
import { McpClient } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

async function testMcpServer() {
  // Connect to MCP server
  const transport = new StdioClientTransport({
    command: "npx",
    args: ["@buena/sdk", "mcp"],
    env: { BUENA_API_KEY: "your-test-key" },
  });

  const client = new McpClient(
    { name: "test-client", version: "1.0.0" },
    { capabilities: {} }
  );

  await client.connect(transport);

  try {
    // Test listing tools
    const tools = await client.listTools();
    console.log(
      "Available tools:",
      tools.tools.map((t) => t.name)
    );

    // Test calling a tool
    const result = await client.callTool({
      name: "buena_health_check",
      arguments: {},
    });
    console.log("Health check result:", result);

    // Test lead operations
    const leads = await client.callTool({
      name: "buena_list_leads",
      arguments: { limit: 3 },
    });
    console.log("Sample leads:", leads);
  } finally {
    await client.close();
  }
}

testMcpServer().catch(console.error);

# Set environment variable
export BUENA_API_KEY=your-api-key
npx @buena/sdk mcp

# Start server with debug logging
DEBUG=* BUENA_API_KEY=your-key npx @buena/sdk mcp --debug

# View detailed logs
tail -f ~/.buena/mcp-server.log

// custom-tools.ts
import { Tool } from "@modelcontextprotocol/sdk/types.js";

export const customTools: Tool[] = [
  {
    name: "buena_lead_analytics",
    description: "Generate analytics report for leads",
    inputSchema: {
      type: "object",
      properties: {
        date_range: {
          type: "string",
          description: 'Date range (e.g., "last_30_days")',
        },
        group_by: {
          type: "string",
          description: "Group by field (company, status, etc.)",
        },
      },
    },
  },
];

// Batch lead creation example for AI assistants
async function batchCreateLeads(leads) {
  const results = [];
  for (const lead of leads) {
    try {
      const result = await mcpClient.callTool({
        name: "buena_create_lead",
        arguments: lead,
      });
      results.push({ success: true, result });
    } catch (error) {
      results.push({ success: false, error: error.message, lead });
    }
  }
  return results;
}

// Example: Send MCP metrics to monitoring service
const mcpMetrics = {
  toolCalls: {
    buena_list_leads: 45,
    buena_create_lead: 12,
    buena_update_lead: 8,
  },
  avgResponseTime: "125ms",
  errorRate: "2.1%",
};

// Send to your monitoring service
await sendMetrics("buena-mcp", mcpMetrics);