MCP Server

This is the official documentation of the @forestadmin/agent Node.js agent.

MCP Server

The MCP Server exposes your Forest Admin agent to external AI assistants (like Claude Desktop) via the Model Context Protocol (MCP).

Enable MCP

const agent = createAgent(options).addDataSource(/* ... */).mountAiMcpServer();

Your MCP endpoint will be available at {your-agent-url}/mcp.

If your application already uses OAuth routes (/oauth/*, /.well-known/*), use standalone mode instead.

Available tools

Tool	Description
list	Search and list records with filters and pagination
create	Create a new record
update	Update an existing record
delete	Delete one or more records
describeCollection	Get schema of a collection
listRelated	List related records
associate	Link records through a relation
dissociate	Unlink records from a relation
getActionForm	Get form fields for a smart action
executeAction	Execute a smart action

Standalone mode

Run the MCP server as a separate process:

npm install @forestadmin/mcp-server

FOREST_ENV_SECRET=xxx FOREST_AUTH_SECRET=xxx npx forest-mcp-server

Variable	Required	Default	Description
FOREST_ENV_SECRET	Yes	-	Your Forest Admin environment secret
FOREST_AUTH_SECRET	Yes	-	Authentication secret (must match your agent)
MCP_SERVER_PORT	No	3931	HTTP server port

Endpoint: {your-standalone-server-url}/mcp

Authentication

The MCP server uses OAuth. Users authenticate with their Forest Admin credentials, and the AI assistant operates with the same permissions as the authenticated user.