FalkorDBSAFE
FalkorDB-MCPServer is an MCP (Model Context Protocol) server that connects LLMs to FalkorDB
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://mcptoplist.com/server/glama%2FFalkorDB%2FFalkorDB-MCPServer)
[](https://github.com/falkordb/FalkorDB-MCPServer/actions/workflows/node.yml) [](https://codecov.io/gh/falkordb/FalkorDB-MCPServer) [](https://github.com/falkordb/FalkorDB-MCPServer/blob/main/LICENSE) [](https://discord.com/invite/99y2Ubh6tg) [](https://x.com/falkordb) [](https://modelcontextprotocol.io)
[](https://app.falkordb.cloud)
A Model Context Protocol (MCP) server for FalkorDB, allowing AI models to query and interact with graph databases. FalkorDB MCP Server enables AI assistants like Claude to interact with FalkorDB graph databases using natural language. Query your graph data, create relationships, and manage your knowledge graph - all through conversational AI.
🎯 What is this?
This server implements the Model Context Protocol (MCP), allowing AI models to:
- Query graph databases using OpenCypher (with read-only mode support)
- Create and manage nodes and relationships
- List and explore multiple graphs
- Delete graphs when needed
- Read-only queries for replica instances or to prevent accidental writes
🚀 Quick Start
Prerequisite
de259d5acbf2OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add mcpserver --env FALKORDB_PASSWORD=${FALKORDB_PASSWORD} --env MCP_API_KEY=${MCP_API_KEY} -- npx -y @falkordb/[email protected]{
"mcpServers": {
"mcpserver": {
"command": "npx",
"args": [
"-y",
"@falkordb/[email protected]"
],
"env": {
"FALKORDB_PASSWORD": "${FALKORDB_PASSWORD}",
"MCP_API_KEY": "${MCP_API_KEY}"
}
}
}
}Exposed tools (7)
6 read · 0 write · 1 destructive. Blast radius: 1 tool can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
delete_graph | destructive | |
get_graph_schema | read | |
get_node_schema | read | |
get_relationship_schema | read | |
list_graphs | read | |
query_graph | read | |
query_graph_readonly | read |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (5)
delete_graph
CLAUDE.md
@modelcontextprotocol/sdk, dotenv, falkordb, platformdirs, zod, @types/jest, @types/node, @typescript-eslint/eslint-plugin
# Using dotenv-cli to load environment variables from .env
When using HTTP transport, clients connect by sending a POST request with an `initialize` message. The server returns an `Mcp-Session-Id` header that must be included in subsequent requests. API key a
Gates applied: no_behavioural_pass.
de259d5acbf2full audit observations/trust-audit/mcp-server/falkordb__falkordb.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | de259d5acbf2 | SAFE | B | 89 | first audit |
Questions
What is the FalkorDB MCP server?
FalkorDB-MCPServer is an MCP (Model Context Protocol) server that connects LLMs to FalkorDB
What tools does FalkorDB expose?
7 in total: 6 read-only, 0 that write, and 1 that can delete or overwrite (delete_graph). Every one is listed on this page with its risk.
Is FalkorDB safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B. Separately from the audit: 1 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does FalkorDB need?
It reads FALKORDB_PASSWORD and MCP_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does FalkorDB run?
It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as @falkordb/mcpserver at 0.0.0-dev.
How current is this page?
The grade is for one exact copy of the source (de259d5acbf2), read on 2026-10-08. The repository is watched and re-audited when it changes.