First setup your environment variables:

touch .env

Add the following to the .env file in the root of the project:

LANGSMITH_API_KEY=lsv2_...

And make another in the agent folder:

cd agent
touch .env

Add the following to the .env file in the agent folder:

OPENAI_API_KEY=sk-...
LANGSMITH_API_KEY=lsv2_...

For development, we recommend running the frontend and agent separately in different terminals to better see errors and logs:

# Terminal 1 - Frontend
pnpm run dev-frontend

# Terminal 2 - Agent
pnpm run dev-agent

This approach makes it easier to spot and debug issues in either the frontend or agent components.

Alternatively, you can run both services together with a single command:

pnpm run dev

Open http://localhost:3000 with your browser to see the result.

The code is factored into 2 parts:

1. The /agent folder: A LangGraph agent that connects to MCP servers and calls their tools

2. The /app folder: a frontend application that uses CopilotKit for UI and state synchronization.