From zero to your first
explanation in under an hour.

# Register at /portal and copy your API key.
# Keys are prefixed with "dc-".

export DC_API_KEY="dc-your-key-here"

curl -s -X POST https://decisioncore.emas.ai/explain \
  -H "Authorization: Bearer $DC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "decision": "Loan application rejected",
    "subject_description": "Applicant DSR 62%, policy ceiling 60%",
    "sector": "financial",
    "tenant_id": "my-org"
  }'

{
  "audit_id": "ADMT-EXP-8a2f1c3d",
  "decision": "Loan application rejected",
  "explanation": "The loan application was rejected because the applicant's
Debt Service Ratio (DSR) of 62% exceeds the institution's affordability
limit of 60% (Credit Policy §3.1). The applicant may ask for a
human review of this automated decision...",
  "regulations_cited": [
    "Credit Policy §3.1 — Affordability limit (DSR)",
    "Credit Policy §5 — Human review on request"
  ],
  "reasoning_chain": "THOUGHT: DSR 62% exceeds the 60% limit. Matched Credit Policy §3.1...",
  "report_url": "/explain/report/ADMT-EXP-8a2f1c3d",
  "results_used": 1,
  "results_remaining": 2
}

Authorization: Bearer dc-your-api-key-here

{
  "audit_id":         "ADMT-EXP-{uuid}",       // unique record ID
  "decision":         "string",                // echoed from request
  "explanation":      "string",                // plain-language explanation
  "regulations_cited": ["string", ...],        // matched provisions
  "reasoning_chain":  "string",                // DeepSeek R1 thought trace
  "report_url":       "/explain/report/{id}", // PDF download URL
  "results_used":      1,
  "results_remaining": integer
}

curl -s -X POST https://decisioncore.emas.ai/explain/report \
  -H "Authorization: Bearer $DC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "decision": "Loan application rejected",
    "subject_description": "Applicant DSR 62%, policy ceiling 60%",
    "sector": "financial",
    "tenant_id": "my-org"
  }' \
  --output dc-explanation.pdf

curl -s https://decisioncore.emas.ai/explain/report/ADMT-EXP-8a2f1c3d \
  -H "Authorization: Bearer $DC_API_KEY" \
  --output ADMT-EXP-8a2f1c3d.pdf

import requests
import os

DC_API_KEY = os.environ["DC_API_KEY"]
BASE_URL   = "https://decisioncore.emas.ai"

HEADERS = {
    "Authorization": f"Bearer {DC_API_KEY}",
    "Content-Type":  "application/json",
}

def explain(decision: str, subject_description: str,
            sector: str = "financial", tenant_id: str = "my-org") -> dict:
    r = requests.post(
        f"{BASE_URL}/explain",
        json={
            "decision":            decision,
            "subject_description": subject_description,
            "sector":             sector,
            "tenant_id":          tenant_id,
        },
        headers=HEADERS,
        timeout=60,
    )
    r.raise_for_status()
    return r.json()


def download_report(audit_id: str, output_path: str) -> None:
    r = requests.get(
        f"{BASE_URL}/explain/report/{audit_id}",
        headers=HEADERS,
        timeout=60,
    )
    r.raise_for_status()
    with open(output_path, "wb") as f:
        f.write(r.content)


# Example: loan rejection
result = explain(
    decision="Loan application rejected",
    subject_description="DSR 62%, institution limit 60%",
    sector="financial",
)

print(f"Audit ID:    {result['audit_id']}")
print(f"Explanation: {result['explanation'][:200]}...")
print(f"Regulations: {result['regulations_cited']}")

# Download the formal PDF
download_report(result["audit_id"], "dc-explanation.pdf")
print("PDF saved to dc-explanation.pdf")

const fs = require('fs');

const DC_API_KEY = process.env.DC_API_KEY;
const BASE_URL   = 'https://decisioncore.emas.ai';

async function explain(decision, subjectDescription, sector = 'financial') {
  const res = await fetch(`${BASE_URL}/explain`, {
    method:  'POST',
    headers: {
      'Authorization': `Bearer ${DC_API_KEY}`,
      'Content-Type':  'application/json',
    },
    body: JSON.stringify({ decision, subject_description: subjectDescription, sector }),
  });
  if (!res.ok) throw new Error(`API error ${res.status}: ${await res.text()}`);
  return res.json();
}

async function downloadReport(auditId, outputPath) {
  const res = await fetch(`${BASE_URL}/explain/report/${auditId}`, {
    headers: { 'Authorization': `Bearer ${DC_API_KEY}` },
  });
  if (!res.ok) throw new Error(`Report error ${res.status}`);
  const buffer = Buffer.from(await res.arrayBuffer());
  fs.writeFileSync(outputPath, buffer);
}

// Example usage
explain('Candidate rejected', 'ATS score 58/100, threshold 65', 'hr')
  .then(async result => {
    console.log('Audit ID:', result.audit_id);
    console.log('Regulations:', result.regulations_cited);
    await downloadReport(result.audit_id, 'dc-explanation.pdf');
    console.log('PDF saved.');
  })
  .catch(console.error);

{
  "mcpServers": {
    "decisioncore": {
      "command": "/path/to/venv/bin/python3",
      "args": ["/path/to/decisioncore/mcp_server.py"],
      "env": {
        "DC_API_KEY":  "dc-your-key-here",
        "DC_BASE_URL": "https://decisioncore.emas.ai"
      }
    }
  }
}

{
  "audit_id":          "ADMT-EXP-8a2f1c3d",
  "decision":          "Loan application rejected",
  "explanation":       "The application was declined because the applicant's Debt Service Ratio (DSR) of 62% exceeds the institution's affordability limit of 60% (Credit Policy §3.1). At this ratio, more than 60% of monthly income would go to debt repayments. The applicant may ask for a human review of this automated decision.",
  "regulations_cited": [
    "Credit Policy §3.1 — Affordability limit (DSR)",
    "Credit Policy §5 — Human review on request",
    "AIGE principles — Transparency"
  ],
  "reasoning_chain":   "THOUGHT: DSR is 62%. The institution's limit is 60%. Exceeded by 2 percentage points. Credit Policy §3.1 applies. CONCLUSION: reject — affordability limit exceeded.",
  "report_url":        "/explain/report/ADMT-EXP-8a2f1c3d",
  "results_used":      1,
  "results_remaining": 9
}