Developers

Give your agents
the ability to understand identity.

The Soulcraft API scores any company's identity across 5 dimensions, generates a complete soul.md, and returns 10 tailored recommendations. Available as a REST API, CLI, and MCP server.

REST API

Call it from anywhere. Returns structured JSON with scores and full soul.md content.

POST /api/soul/analyze

CLI

Analyze any domain from your terminal. Pipe scores, save soul.md files, or trigger PDF reports. Download soul.py on GitHub.

python soul.py analyze

MCP Server

Native tool for Claude Desktop, Cowork, and any MCP-compatible agent.

npx soulcraft-mcp

Five dimensions. One score.

Every analysis returns a Soul Score (0-100) built from five weighted dimensions.

Identity Clarity
How clearly defined the origin, purpose, and beliefs are. Can a stranger understand what this company stands for?
Voice Consistency
How uniform and distinctive the communication style is across channels and touchpoints.
AI Readiness
How well the identity translates to machine-readable context. Can an AI agent reliably represent this company?
Positioning
How distinct and defensible the competitive position is. Is this company hard to confuse with anyone else?
Content Signal
How much indexed, attributable, on-brand content exists to reinforce the identity in the world.

API

One endpoint. Point it at a domain, get back identity intelligence.

# Analyze any domain
curl -X POST https://soulcraft-report-production.up.railway.app/api/soul/analyze \
  -H "Content-Type: application/json" \
  -H "X-Soul-Key: sc_your_key" \
  -d '{"domain": "stripe.com"}'
# Response
{
  "company": "Stripe",
  "domain": "stripe.com",
  "scores": {
    "identity": 82,
    "voice": 75,
    "ai": 61,
    "position": 88,
    "content": 79,
    "overall": 77
  },
  "soul": { /* full soul.md sections */ }
}

MCP server

Add to Claude Desktop or Cowork and your agents get identity analysis as a native tool.

# Install
npx soulcraft-mcp

# claude_desktop_config.json
{
  "mcpServers": {
    "soul": {
      "command": "npx",
      "args": ["-y", "soulcraft-mcp"],
      "env": {
        "SOUL_API_URL": "https://soulcraft-report-production.up.railway.app",
        "SOUL_API_KEY": "sc_your_key"
      }
    }
  }
}

Available tools: analyze_identity and get_soul_file

Get your free API key

Free tier: 3 analyses per day. No credit card required.

We'll send a confirmation email. Your key arrives after you verify.

Check your email.

We sent a verification link to . Click it to get your key. Check your spam folder if it doesn't arrive in a minute.

You're verified.

Your API key is on its way. Check your inbox -- it includes setup instructions for the CLI and MCP server.

Something went wrong.

Please try again or email hello@soulcraftagency.com.