Skip to main content

Database Hosted Service

KnowledgeFlowDB offers a fully-managed, production-ready hosted database service. Get started in minutes without managing infrastructure.

Get Started​

Visit db.knowledgedataflow.org to:

  • Connect your wallet and get instant database access
  • Your wallet address is your identity — no accounts or passwords needed
  • Start querying and building immediately
  • Scale automatically as your data grows

Authentication​

KnowledgeFlowDB uses wallet-based authentication. Your Ethereum wallet address is your identity.

Simple Access​

Include your wallet address in requests:

curl -X POST https://api.knowledgedataflow.org/api/v1/query \
  -H "X-Wallet-Address: 0xYOUR_WALLET_ADDRESS" \
  -H "Content-Type: application/json" \
  -d '{"query": "MATCH (n) RETURN count(n)"}'

Full Authentication Flow​

For production use, authenticate via EIP-191 challenge/verify to get a Bearer JWT token (valid 24 hours):

  1. Get challenge: GET /api/auth/challenge — returns a nonce and message to sign
  2. Sign message: Sign the challenge with your wallet (EIP-191 personal_sign)
  3. Verify: POST /api/auth/verify with wallet address, signature, and nonce — returns a JWT

See the Authentication docs for the complete guide.

Pricing: Pay-Per-Call with x402​

KnowledgeFlowDB uses the x402 payment protocol for transparent, per-call pricing:

  • $0.0005 per tool call (half a thousandth of a cent)
  • USDC on Base chain (chain ID 8453)
  • No subscriptions — pay only for what you use
  • EIP-712 TransferWithAuthorization for secure, gasless payments

Payments are handled via the X-PAYMENT header using signed USDC authorization. The rickydata SDK handles payment signing automatically.

For AI agents, the MCP marketplace provides 150+ tools with integrated x402 payment flow.

Free Endpoints​

These endpoints require no payment:

  • GET /health — Health check
  • GET /api/servers — List MCP servers
  • GET /api/servers/:id/tools — List server tools
  • GET /api/servers/:id/skill — Get server skill docs

Programmatic Access​

rickydata SDK​

The recommended way to interact with KnowledgeFlowDB programmatically:

npm install @nickydata/sdk

The SDK handles wallet authentication, x402 payment signing, and provides typed APIs for all endpoints. See the SDK docs for details.

MCP Integration​

For AI agents, KnowledgeFlowDB is available as an MCP server with 150+ tools covering:

  • Graph queries (KQL and SQL)
  • Semantic code search
  • Entity management
  • GitHub repository import
  • Session tracking and analytics

See the MCP docs for integration details.

Architecture​

The hosted service is built on:

  • ScyllaDB Cluster: 3-node cluster with QUORUM consistency for ACID guarantees
  • ClickHouse: Analytics replica synced via CDC for fast KQL queries
  • Auto-Scaling API: 3-10 pods based on load (HPA)
  • Performance: 100K+ QPS per node
  • Deployment: Google Kubernetes Engine (GKE)
  • Multi-Tenant: Complete keyspace isolation per tenant via wallet address

Try It Now​

The interactive query examples on the KQL Syntax page let you connect to your own database instance. Just provide your API endpoint and wallet address to start experimenting.