API Documentation

Authenticate, discover tools, and generate production-ready code — all via REST.

1. Get Access

We're doing personal onboarding for early adopters. Email us to get started:

email
To: hello@crowvault.ai
Subject: CrowVault API Access Request

Name: Your Name
Company: Your Company
Use case: What you're building

We'll respond within 24 hours with your credentials, a personal onboarding call, and early-adopter pricing (50% off first month).

2. Authenticate

Exchange your credentials for a Bearer token. Tokens are valid for 8 hours (Developer) or 24 hours (Team).

bash
curl -X POST https://api.crowvault.ai/v1/token \
  -H "Content-Type: application/json" \
  -d '{
    "username": "YOUR_USERNAME",
    "password": "YOUR_PASSWORD"
  }'
response
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "type": "Bearer",
  "expiresAt": "2026-03-19T12:00:00.000Z",
  "expiresIn": "8h"
}

3. Discover Tools

Browse all 132 tools across 4 servers, or filter by server.

List all servers

bash
curl -s https://api.crowvault.ai/v1/servers \
  -H "Authorization: Bearer $TOKEN"

List tools for a server

bash
# Available servers: fullstack-enhanced, database-mcp, devops-mcp, api-mcp
curl -s https://api.crowvault.ai/v1/servers/database-mcp/tools \
  -H "Authorization: Bearer $TOKEN"

List all tools (flat)

bash
curl -s "https://api.crowvault.ai/v1/tools?server=database-mcp" \
  -H "Authorization: Bearer $TOKEN"

4. Call a Tool

Execute any tool by providing the server, tool name, and arguments. Typical response time: 500-700ms.

bash
curl -X POST https://api.crowvault.ai/v1/tools/call \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "server": "database-mcp",
    "tool": "design_schema",
    "args": {
      "aggregate": "Order",
      "fields": ["id:uuid", "total:decimal", "status:string", "customerId:uuid"],
      "database": "postgresql"
    }
  }'
response
{
  "success": true,
  "result": "CREATE TABLE orders (\n  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),\n  total DECIMAL NOT NULL,\n  status VARCHAR(255) NOT NULL,\n  customer_id UUID NOT NULL,\n  created_at TIMESTAMPTZ DEFAULT NOW(),\n  updated_at TIMESTAMPTZ DEFAULT NOW()\n);",
  "meta": {
    "server": "database-mcp",
    "tool": "design_schema",
    "durationMs": 694
  }
}

5. Server Reference

Fullstack MCP 38 tools

Server ID: fullstack-enhanced

DDD aggregates, value objects, repositories, use cases, domain events, API endpoints, frontend components, test suites, clean architecture layers, microservice scaffolding, sagas, and more.

Database MCP 33 tools

Server ID: database-mcp

Schema design, migrations, query optimization, ORM models, indexes, connection pooling, event stores, read models, multi-tenancy, sharding, replication, backup strategies, and more.

DevOps MCP 31 tools

Server ID: devops-mcp

Dockerfiles, Docker Compose, Kubernetes deployments, Helm charts, Terraform modules, GitHub Actions, GitLab CI, Prometheus configs, Grafana dashboards, service mesh, network policies, and more.

API MCP 30 tools

Server ID: api-mcp

OpenAPI specs, GraphQL schemas, gRPC protos, rate limiting, OAuth2 configs, JWT auth, circuit breakers, webhook handlers, event buses, Stripe/Twilio/SendGrid integrations, and more.

6. API Reference

Method Endpoint Auth Description
POST /v1/token None Get Bearer token
GET /v1/servers Bearer List all servers with status
GET /v1/servers/:id/tools Bearer List tools for a server
GET /v1/tools Bearer List all tools (filterable)
POST /v1/tools/call Bearer Execute a tool
GET /health None Health check

Rate Limits

Endpoint Limit Window
Authentication 5 requests 15 minutes
API endpoints (/v1/*) 60 requests 1 minute
Tool calls (Dashboard) 30 requests 1 minute

Error Handling

All errors return JSON with an error field:

json
{ "error": "Token expired" }           // 401 — re-authenticate
{ "error": "Unknown server: foo" }     // 404 — check server ID
{ "error": "API rate limit exceeded" } // 429 — wait and retry

Need help? We're here.

Email: support@crowvault.ai
Response time: under 24 hours.

Request Early Access