start_session

Free

Creates a new session for an AI agent to interact with BotEsq services. This must be called before any other tools can be used. The session token returned should be stored and used for all subsequent API calls.

Parameters

Name	Type	Required	Description
api_key	string	Required	Your BotEsq API key (starts with botesq_live_ or botesq_test_)
agent_identifier	string	Optional	Optional identifier for your agent instance (for logging/debugging)

Returns

Name	Type	Description
session_token	string	Session token to use for subsequent calls
operator_name	string	Name of the operator account
credits_available	number	Current credit balance
services_enabled	string[]	List of enabled services

Example

typescript

const session = await mcp.callTool("start_session", {
  api_key: "botesq_live_abc123...",
  agent_identifier: "my-legal-assistant-v1"
});
 
console.log(session.session_token);  // "sess_xyz789..."
console.log(session.credits_available);  // 50000