The Agent-Ready Backend for MongoDB.
# Add to your Claude Code skills
git clone https://github.com/SoftInstigate/restheartLast scanned: 5/6/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-06T06:29:39.383Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}restheart is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by SoftInstigate. The Agent-Ready Backend for MongoDB. It has 877 GitHub stars.
Yes. restheart passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/SoftInstigate/restheart" and add it to your Claude Code skills directory (see the Installation section above).
restheart is primarily written in Java. It is open-source under SoftInstigate on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh restheart against similar tools.
No comments yet. Be the first to share your thoughts!
RESTHeart exposes your data through a native MCP server and full REST and GraphQL APIs, so AI agents and developers can read and write without custom integration code.

RESTHeart gives AI agents and developers instant, secure access to MongoDB. It ships with a native MCP server that any MCP-compatible client (Claude, Claude Code, Cursor, VS Code) can connect to out of the box, plus full REST, GraphQL, and WebSocket APIs for traditional application development. Built-in authentication and authorization, zero backend boilerplate, and a plugin framework for custom business logic when you need it.
Available as a Docker image and GraalVM native binary. Built on Java 25, Undertow, and virtual threads.
Core capabilities:
/metrics-ui — track request rates, latency percentiles, and HTTP status distributionRESTHeart ships with Sophia, a native Model Context Protocol (MCP) server. Any MCP-compatible AI client can connect directly.
Public demo endpoints (no authentication required):
https://sophia-api.restheart.com/mcp/restheart/ — RESTHeart docs knowledge base
https://sophia-api.restheart.com/mcp/cloud/ — RESTHeart Cloud docs knowledge base
Connect with Claude Code:
claude mcp add --transport http sophia-restheart https://sophia-api.restheart.com/mcp/restheart
claude mcp add --transport http sophia-cloud https://sophia-api.restheart.com/mcp/cloud
Connect with Claude Desktop: Open Settings → Connectors → Add custom connector and paste one of the context URLs above.
Connect with Streamable HTTP clients (add to MCP settings):
{
"sophia": {
"type": "http",
"url": "https://sophia-api.restheart.com/mcp/restheart/"
}
}
Connect with stdio clients (VS Code, Zed — requires Node.js 18+):
{
"sophia": {
"command": "npx",
"args": ["mcp-remote", "https://sophia-api.restheart.com/mcp/restheart/"]
}
}
For private Sophia instances, replace the URL with your own base URL and context ID, and add authentication. See the MCP documentation for details.
To get RESTHeart running in few minutes and make your first API call, there are several options. Choose the one that best fits your needs:
Option 1 — Deploy on RESTHeart Cloud (no install required)
The fully managed service by SoftInstigate. No infrastructure to configure or maintain — just sign up and start building. Includes a dashboard, SLA, and support.
Option 2 — Deploy on Railway (no install required)
Deploy RESTHeart and MongoDB on your own Railway account in one click. You keep full control of the infrastructure. Free to start, pay only for what you use on Railway.
Option 3 — Docker Compose (local):
# Start MongoDB + RESTHeart with Docker Compose
curl https://raw.githubusercontent.com/SoftInstigate/restheart/master/docker-compose.yml \
--output docker-compose.yml && docker compose up --attach restheart
# Test it
curl http://localhost:8080/ping
Default credentials: admin / secret (change in production)
More options: https://restheart.org/docs/foundations/quick-start
const url = encodeURI('https://demo.restheart.org/messages?filter={"from":"Bob"}&pagesize=1');
fetch(url)
.then(response => response.json())
.then(json => console.log(JSON.stringify(json, null, 2)));
That's it. No Express routes, no Mongoose schemas, no middleware setup.
📄 Full documentation: https://restheart.org/docs/
RESTHeart ships with a built-in real-time metrics dashboard and a Prometheus-compatible endpoint. No external tools required.
Metrics UI — Open /metrics-ui in your browser after starting RESTHeart to access the real-time dashboard.
The dashboard displays:
Prometheus endpoint — Scrape /metrics (or /metrics/requests, /metrics/jvm) in Prometheus format for integration with external monitoring stacks.
Configuration — Enabled by default. Key settings in restheart.yml:
metrics:
enabled: true
uri: /metrics
requestsMetricsCollector:
enabled: true
include: ["/*"]
exclude: ["/metrics", "/metrics/*"]
jvmMetricsCollector:
enabled: false # set to true for JVM memory and GC metrics
📖 Full documentation: docs/metrics.md
Write custom logic only when you need it. RESTHeart handles the rest.
@RegisterPlugin(name = "greetings")
public class GreeterService implements JsonService {
@Override
public void handle(JsonRequest req, JsonResponse res) {
res.setContent(object()
.put("message", "Hello World!")
.put("timestamp", Instant.now()));
}
}
export const options = {
name: "greetings",
uri: "/greetings"
}
export function handle(request, response) {
response.setContent(JSON.stringify({
message: 'Hello World!',
timestamp: new Date().toISOString()
}));
response.setContentTypeAsJson();
}
Plugin types:
📖 Plugin development: https://restheart.org/docs/plugins/overview/
🔧 Use restheart-cli for scaffolding, testing, and hot-reload.
docker pull softinstigate/restheart:latest
docker run -p 8080:8080 \
-v ./restheart.yml:/opt/restheart/etc/restheart.yml \
softinstigate/restheart
Stateless architecture supports horizontal scaling. Configure with ConfigMaps and Secrets.
Prebuilt binaries for macOS, Linux, and Windows with faster startup and lower memory footprint.
See docs/native-executables.md for download links.
Fully managed service: cloud.restheart.com