A pre-built LangGraph tools agent for Open Agent Platform. It contains support for MCP servers and a LangConnect RAG tool.
[!TIP] This project is built for Open Agent Platform, a citizen developer platform for building, testing, and using agents.
First, clone the repository and create a new virtual environment:
git clone https://github.com/langchain-ai/oap-langgraph-tools-agent.git
bash
uv venv
Activate the virtual environment:
bash
source .venv/bin/activate
Install dependencies:
bash
uv sync
Then set the environment variables:
bash
cp .env.example .env
This project requires a Supabase account with authentication to be setup. This is because this project implements custom LangGraph authentication so that it can be called directly from a web client.
After setting your environment variables, you can start the server by running:
bash
# The --no-browser will disable auto-opening LangGraph studio when the server starts
# optional, but recommended since the studio is not needed for this project
uv run langgraph dev --no-browser
http://localhost:2024.GraphConfigPydantic class in the agent.py file. OAP will automatically register any changes to this class. You can modify a specific field's properties by editing the x_oap_ui_config metadata object. For more information, see the Open Agent Platform documentation on graph configuration.This project uses LangGraph custom auth to authenticate requests to the server. It's configured to use Supabase as the authentication provider, however it can be easily swapped for another service.
Authorization header with a Bearer token. This token should be a valid JWT token from Supabase (or another service that implements the same authentication protocol).The auth handler then takes that token and verifies it with Supabase. If the token is valid, it returns the user's identity. If the token is invalid, it raises an exception. This means you must have a Supabase URL & key set in your environment variables to use this auth handler:
bash
SUPABASE_URL=""
# Ensure this is your Supabase Service Role key
SUPABASE_KEY=""
The auth handler is then used as middleware for all requests to the server. It is configured to run on the following events:
threads.createthreads.readthreads.deletethreads.updatethreads.searchassistants.createassistants.readassistants.deleteassistants.updateassistants.searchstoreFor creation methods, it auto-injects the user's ID into the metadata. This is then uses in all read/update/delete/search methods to ensure that the user can only access their own threads and assistants.
By using custom authentication, we can call this LangGraph server directly from a frontend application, without having to worry about exposing API keys/secrets, since you only need a JWT token from Supabase to authenticate.
This agent is configured to accept model API keys set by a user in the OAP settings page. The default OAP implementation allows users to add their own OpenAI, Anthropic, and Google API keys, and these can easily be extended in OAP.
If a user sets their API keys in the OAP settings page, those keys will be passed to the agent through the config in an 'apiKeys' field and used by default. Otherwise, we will automatically fall back on the environment variables set in the agent deployed on LangGraph platform.