Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mcp-use.com/llms.txt

Use this file to discover all available pages before exploring further.

MCPAgent provides flexible memory management options to control how conversation history is handled. You can choose between different memory strategies depending on your use case.

​
Memory Modes

​
1. Self-Managed Memory (memoryEnabled: true)

When memoryEnabled is set to true (the default), the agent automatically manages conversation history internally. This is the simplest option for most use cases. 
import { MCPAgent, MCPClient } from "mcp-use";
import { ChatOpenAI } from "@langchain/openai";

const client = new MCPClient({
  mcpServers: {
    filesystem: {
      command: "npx",
      args: ["-y", "@modelcontextprotocol/server-filesystem", "./"]
    }
  }
});

const llm = new ChatOpenAI({ model: "gpt-4o" });

const agent = new MCPAgent({
  llm,
  client,
  memoryEnabled: true  // Agent manages memory internally (default)
});

// The agent will automatically maintain conversation context
const response1 = await agent.run("Hello, my name is Alice");
const response2 = await agent.run("What's my name?");  // Agent remembers Alice

await client.closeAllSessions();

​
2. No Memory (memoryEnabled: false)

When memoryEnabled is set to false, the agent has no internal memory and treats each interaction independently. 
const agent = new MCPAgent({
  llm,
  client,
  memoryEnabled: false  // No internal memory
});

// Each interaction is independent
const response1 = await agent.run("Hello, my name is Alice");
const response2 = await agent.run("What's my name?");  // Agent doesn't remember Alice

await client.closeAllSessions();

​
Memory Management Methods

The MCPAgent provides methods to inspect and control conversation history:

​
getConversationHistory()

Returns a copy of the current conversation history as an array of messages. 
const history = agent.getConversationHistory();
console.log(`Current history has ${history.length} messages`);

// Inspect message types
for (const message of history) {
  console.log(message.constructor.name, message.content);
}

​
clearConversationHistory()

Clears the internal conversation history. If memoryEnabled is true and a system message exists, it will be preserved. 
// Clear conversation history
agent.clearConversationHistory();
console.log("Conversation history cleared");

// Start fresh conversation
const response = await agent.run("Start a new conversation");

​
Next Steps

Agent Configuration

Learn more about configuring agents

Structured Output

Generate type-safe responses with Zod schemas

Streaming

Stream agent responses in real-time