HarperDB

Distributed edge database combining SQL and NoSQL in a single JSON-native system with built-in replication and custom functions.

Evaluated Mar 06, 2026 (0d ago) vcurrent
Homepage ↗ Other database edge sql nosql json real-time
⚙ Agent Friendliness
56
/ 100
Can an agent use this?
🔒 Security
61
/ 100
Is it safe for agents?
⚡ Reliability
54
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
--
Documentation
75
Error Messages
72
Auth Simplicity
82
Rate Limits
80

🔒 Security

TLS Enforcement
0
Auth Strength
78
Scope Granularity
75
Dep. Hygiene
75
Secret Handling
78

TLS must be configured separately — not enabled by default in self-hosted deployment.

⚡ Reliability

Uptime/SLA
0
Version Stability
72
Breaking Changes
70
Error Recovery
72
AF Security Reliability

Best When

Best for edge deployments needing SQL + NoSQL flexibility with built-in replication and low-latency data access.

Avoid When

Avoid when standard PostgreSQL ecosystem compatibility is required or when managed cloud service is mandatory.

Use Cases

  • Deploy database logic at edge locations for low-latency agent data access globally
  • Run SQL queries over schema-less JSON documents without predefined schemas
  • Build real-time pub/sub event streams using HarperDB's native messaging layer
  • Execute custom application logic as serverless functions collocated with data
  • Implement multi-region data replication for globally distributed agent pipelines

Not For

  • Workloads requiring PostgreSQL/MySQL ecosystem compatibility and tooling
  • Large-scale OLAP analytics requiring columnar storage optimization
  • Teams needing a fully managed cloud service with enterprise SLA without self-hosting

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
No
SDK
Yes
Webhooks
No

Authentication

Methods: basic_auth api_key
OAuth: No Scopes: Yes

HTTP Basic auth or API tokens. Role-based access control with super_user, cluster_user, and custom roles.

Pricing

Model: freemium
Free tier: Yes
Requires CC: No

HarperDB Cloud (managed) has usage-based pricing. Self-hosted free for development.

Agent Metadata

Pagination
offset
Idempotent
Partial
Retry Guidance
Not documented

Known Gotchas

  • All REST API operations use POST with operation field in JSON body — there are no distinct HTTP methods per operation type
  • hash_attribute (primary key) must be defined at table creation — records without hash_attribute get auto-generated UUIDs
  • SQL queries go through the same POST endpoint as NoSQL operations — use sql operation type, not a separate SQL endpoint
  • Custom Functions run in Node.js collocated with DB — function deployment restarts the custom functions server, causing brief downtime
  • Replication setup requires clustering license — single-node free tier cannot replicate to other HarperDB instances

Alternatives

Full Evaluation Report

Detailed scoring breakdown, competitive positioning, security analysis, and improvement recommendations for HarperDB.

$99

Scores are editorial opinions as of 2026-03-06.

5178
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
Community Powered