Developers · MCP server

Drop AgentSmack into every agent's toolbox.

AgentSmack speaks the Model Context Protocol. Any MCP client — Claude Desktop, Cursor, custom agents — can register /api/mcp/v1 as a server and invoke agentsmack.analyze as a tool from inside an LLM session. "Analyze yourself" becomes a one-tool-call loop.

Endpoint

POST https://agentsmack.com/api/mcp/v1

# JSON-RPC 2.0 — single requests + batch arrays both accepted.

# Protocol version: 2025-06-18.

Tool catalog

Tool	What it does	Args
agentsmack.analyze	Submit a system prompt + tool list, get back a submissionId + public report URL.	systemPrompt, toolList?, model?, agentLabel?, framework?
agentsmack.get_report	Fetch the structured AgentSmack report for a prior submission.	submissionSlug
agentsmack.verify_pack	Verify a signed governance pack offline (Ed25519 + content-addressed packId).	packJson, signatureHex?, publicKeyHex?

Claude Desktop config

Add the snippet to ~/.config/claude/mcp.json (macOS / Linux) or %APPDATA%\Claude\mcp.json (Windows). Reload Claude Desktop.

{
  "mcpServers": {
    "agentsmack": {
      "transport": {
        "type": "http",
        "url": "https://agentsmack.com/api/mcp/v1"
      },
      "headers": {
        "Authorization": "Bearer as_pat_<your-token-hex>"
      }
    }
  }
}

Cursor config

Cursor > Settings > MCP > Add server. Or edit ~/.cursor/mcp.json directly.

{
  "mcpServers": {
    "agentsmack": {
      "url": "https://agentsmack.com/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer as_pat_<your-token-hex>"
      }
    }
  }
}

Raw curl examples

Same JSON-RPC any MCP client speaks. The Authorization header is optional — anonymous callers get the basic-tier rate limit.

initialize

curl -X POST https://agentsmack.com/api/mcp/v1 \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

tools/list

curl -X POST https://agentsmack.com/api/mcp/v1 \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

tools/call — agentsmack.analyze

curl -X POST https://agentsmack.com/api/mcp/v1 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer as_pat_<your-token-hex>' \
  -d '{
    "jsonrpc":"2.0",
    "id":3,
    "method":"tools/call",
    "params":{
      "name":"agentsmack.analyze",
      "arguments":{
        "systemPrompt":"You are a helpful coding assistant.",
        "toolList":[{"name":"search_web","description":"Search the web"}],
        "model":"gpt-4o"
      }
    }
  }'

Auth

Anonymous — no header. Per-IP rate limited (default 30/hour). The tool result still includes a public report URL; just no workspace history.

Workspace token — Authorization: Bearer as_pat_<32-hex>. Mint one from your dashboard settings. Tokens are workspace-scoped, revocable, and never logged in plaintext.

Try it from your terminal first.

The endpoint is live. Paste the curl above and you'll get a real public report URL back in < 2 s.

Mint a token