API Reference

Create a new account. Returns an API key (shown once). No authentication required.

curl -X POST https://dke-forge.com/v1/register \
  -H "Content-Type: application/json" \
  -d '{"name": "Jane Doe", "email": "jane@example.com"}'

Response (201):

{
  "id": "a1b2c3d4e5f6a7b8",
  "name": "Jane Doe",
  "email": "jane@example.com",
  "tier": "cycle",
  "api_key": "fga_0123456789abcdef...",
  "message": "Welcome to DKE-Forge beta! Save your API key..."
}

Check if your API key is valid and see your account details.

curl -X POST https://dke-forge.com/v1/auth/verify \
  -H "Authorization: Bearer fga_your_key"

Node and edge counts, type breakdown, thermal zone distribution.

curl https://dke-forge.com/v1/graph/stats \
  -H "Authorization: Bearer fga_your_key"

Look up a function by name. Returns node details including properties, temperature, and confidence.

curl https://dke-forge.com/v1/graph/function/handleRegister \
  -H "Authorization: Bearer fga_your_key"

Functions that call the named function. Optional ?depth=N (default 2).

curl "https://dke-forge.com/v1/graph/callers/authenticate?depth=3" \
  -H "Authorization: Bearer fga_your_key"

Functions called by the named function. Optional ?depth=N (default 2).

curl "https://dke-forge.com/v1/graph/callees/main?depth=2" \
  -H "Authorization: Bearer fga_your_key"

Files and modules that the named entity depends on (DependsOn, Includes, UsesType edges).

curl https://dke-forge.com/v1/graph/depends/graph.cpp \
  -H "Authorization: Bearer fga_your_key"

What breaks if you change this function? Returns directly affected, transitively affected, and test cases that need re-running. Optional ?change_type=modify|remove|rename.

curl "https://dke-forge.com/v1/graph/impact/ForgeGraph?change_type=modify" \
  -H "Authorization: Bearer fga_your_key"

Response includes:

{
  "changed": { ... },
  "change_type": "modify",
  "directly_affected": [ ... ],
  "transitively_affected": [ ... ],
  "test_cases_affected": [ ... ],
  "files_to_update": [ "graph.cpp", "store.cpp" ]
}

List all registered coding rules (naming conventions, complexity limits, etc.).

Check a function against all rules. Returns violations.

List learned structural patterns in your graph.

Pattern details including exemplar functions and edge-profile centroid.

Assemble a Cartographer envelope. Returns both structured JSON and serialized text ready for LLM consumption.

curl -X POST https://dke-forge.com/v1/envelope \
  -H "Authorization: Bearer fga_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "authenticate",
    "task": "Add rate limiting by IP address"
  }'

Run the full Forge Cycle. Assembles context, calls your LLM, audits the result, retries on failure.

curl -X POST https://dke-forge.com/v1/generate \
  -H "Authorization: Bearer fga_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "handleRegister",
    "task": "Add CAPTCHA verification before registration",
    "llm_provider": "anthropic",
    "llm_key": "sk-ant-api03-your-key-here"
  }'

Response:

{
  "accepted": true,
  "attempts": 1,
  "total_ms": 3200,
  "provider": "anthropic/claude-sonnet-4-20250514",
  "target": "handleRegister",
  "task": "Add CAPTCHA verification...",
  "code": "static void handleRegister(...) { ... }",
  "attempt_details": [ ... ]
}

Ingest a repository into your code graph. Supports C++, Python, and TypeScript.

No authentication required. Returns server status and version.

curl https://dke-forge.com/health

{"status": "ok", "version": "0.2.0"}

pip install dke-forge

dke-forge config set api_key fga_your_key

Stores your API key in ~/.config/dke-forge/config.json (file permissions set to 600).

dke-forge health                      # Server status
dke-forge graph stats                  # Node and edge counts
dke-forge graph function main          # Look up a function
dke-forge graph callers authenticate   # Who calls this?
dke-forge graph callees main           # What does this call?

The server ships as an optional extra on the dke-forge PyPI package:

pip install 'dke-forge[mcp]'

Pure-Python HTTP client — no local graph engine, no native dependencies. Source at github.com/OpenLangSyn/dke-forge (MIT).

Add this to .mcp.json at your project root (or ~/.mcp.json for global):

{
  "mcpServers": {
    "forge": {
      "command": "dke-forge-mcp",
      "env": {
        "FORGE_URL": "https://dke-forge.com",
        "FORGE_API_KEY": "fga_your_key"
      }
    }
  }
}

On startup the server pings /health, then advertises 27 tools over stdio. Claude Code discovers them automatically.