GPTBots MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with GPTBots MCP or direct API to query knowledge bases, manage conversations, read and write databases, and surface usage analytics through natural language.

GPTBots logoGPTBots
Api Key

GPTBots is an enterprise AI agent platform for conversations, knowledge management, databases, user data, and analytics. Use it to build context-aware agents that search knowledge, manage conversations, and surface usage insights.

12 Tools

Try GPTBots now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
GPTBots
Try asking
TOOLS

Supported Tools

Every GPTBots action and event your agent gets out of the box.

Create Conversation

Create a GPTBots conversation for a developer-defined user on the Agent connected by this API key.

Get Agent Information

Return the GPTBots Agent bound to the connected Agent API Key, including its ID and runtime configuration.

Get Total Credit Consumption

Return aggregate Agent credit consumption by category for a reporting range of up to 365 days.

List Conversation Credits

Return one page of per-conversation Agent credit consumption for a time range of up to 30 days, optionally filtered by conversation ID.

List Conversation Messages

Return one page of current v2 message details for a GPTBots conversation.

List Conversations

Return one page of Agent conversations filtered by source, recent-chat time range, and optional user.

List Database Tables

Return database tables configured for the Agent ID supplied by the caller.

List Knowledge Bases

Return all knowledge bases attached to the GPTBots Agent connected by this API key.

List Knowledge Documents

Return one page of documents in a GPTBots knowledge base.

List Metadata Fields

Return global and per-knowledge-base document metadata field definitions for the connected GPTBots Agent.

Query User Attributes

Return configured GPTBots Agent attributes for either developer user IDs or anonymous IDs.

Send Message

Send the latest user text to a GPTBots conversation in blocking mode; a response may signal a Custom Helpdesk human handoff, or the message may be archived without an AI response during human takeover.

SETUP GUIDE

Connect GPTBots MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["gptbots"],
  mcp: true,
});
Create a session scoped to GPTBots and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Search the knowledge base for password reset and summarize top results",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a GPTBots request
SETUP GUIDE

Connect GPTBots API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["gptbots"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to GPTBots
3

Run GPTBots tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Search the knowledge base for password reset and summarize top results" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the GPTBots tool calls through the session, and print the final answer

Why Use Composio?

AI Native GPTBots Integration

  • Supports both GPTBots MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your GPTBots data

Managed Auth

  • Built-in API key handling with secure storage
  • Central place to manage, scope, and revoke GPTBots access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access GPTBots
  • Scoped, least privilege access to GPTBots resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with GPTBots.It takes 30 seconds.

Managed auth, hosted MCP servers, and every GPTBots tool your agent needs.Free to start.

Start building