Skip to main content

Overview

Create a bot that uses MCP tools to access external services like Gmail, HubSpot, and custom APIs.

Prerequisites

npm install @boostgpt/core-sdk

Complete Example

import { BoostGPT } from '@boostgpt/core-sdk';

const client = new BoostGPT({
  apiKey: process.env.BOOSTGPT_API_KEY
});

async function main() {
  // 1. Create bot
  const botResult = await client.createBot({
    name: 'Sales Assistant',
    model: 'gpt-4o',
    instruction: `You are a sales assistant with access to:
    - CRM (search customers, create deals)
    - Email (send messages)
    - Calendar (schedule meetings)
    
    Help users with sales tasks using these tools.`
  });

  const botId = botResult.response.id;
  console.log('Bot created:', botId);

  // 2. Connect MCP tools
  // Via Dashboard: Agent → Tools → Add Tool
  // Add your MCP servers:
  // - CRM: https://mcp.boostgpt.co/crm-server
  // - Email: Gmail connector
  // - Calendar: Google Calendar connector

  // 3. Chat with bot (it will use tools automatically)
  const chatResult = await client.chat({
    bot_id: botId,
    message: 'Find customer john@acme.com and schedule a follow-up call',
    chat_id: 'sales-rep-1'
  });

  console.log('Bot:', chatResult.response);
  // Bot will:
  // 1. Search for customer in CRM
  // 2. Check calendar for availability
  // 3. Schedule meeting
  // 4. Send calendar invite via email
}

main();

Use Case: Customer Support

// Bot with support tools
const supportBot = await client.createBot({
  name: 'Support Agent',
  model: 'gpt-4o',
  instruction: `You are a customer support agent with access to:
  - Ticketing system
  - Knowledge base
  - Customer database
  
  Help resolve customer issues efficiently.`
});

// Connect tools via Dashboard:
// - Zendesk connector
// - Notion (knowledge base)
// - Internal CRM MCP server

// Test
const response = await client.chat({
  bot_id: supportBot.response.id,
  message: 'Customer john@example.com reports login issues',
  chat_id: 'support-session-1'
});

// Bot will:
// - Look up customer in CRM
// - Search knowledge base for login solutions
// - Create support ticket
// - Send resolution to customer

Use Case: Sales Automation

const salesBot = await client.createBot({
  name: 'Sales Automation',
  model: 'gpt-4o',
  instruction: 'Automate sales workflows using CRM, email, and calendar tools.'
});

// Connect: HubSpot, Gmail, Google Calendar

// Example workflow
await client.chat({
  bot_id: salesBot.response.id,
  message: `For all leads from yesterday:
  1. Check if they've been contacted
  2. Send personalized intro email
  3. Schedule follow-up for next week`,
  chat_id: 'automation-1'
});

Creating Custom MCP Servers

1. Create MCP Server from OpenAPI

Dashboard → MCP Servers → Create Server
→ Import OpenAPI
→ Paste: https://api.yourservice.com/openapi.json
→ Generate

MCP URL: https://mcp.boostgpt.co/your-server-id

2. Connect to Bot

Agent → Tools Tab → Add Tool → Add New
→ Enter MCP URL
→ Configure authentication
→ Test in Playground

3. Use in Code

// Bot automatically uses connected tools
const result = await client.chat({
  bot_id: botId,
  message: 'Use my custom API to fetch user data',
  chat_id: 'user-1'
});

// Bot will call your MCP server's tools

Next Steps