agentsfirst-mcp

Remote MCP server. Score any public website against the 8 Agents First principles. No install required — point your agent runtime at this URL.

Add this MCP server to your agent

Claude Code (~/.claude.json or .claude/mcp.json):

{
  "mcpServers": {
    "agentsfirst": {
      "type": "http",
      "url": "https://agentsfirst.dev/mcp"
    }
  }
}

Cursor (.cursor/mcp.json) — same shape. Cline / Windsurf / generic clients — drop the same block into the client's MCP config.

Tools

• agentsfirst_prep — Prep Gate. Call first. Verifies rubric loaded + canonical API reachable.
• score_website — HTTP-probes a public URL across 5 dimensions, returns 0–100 score + level + top moves.
• get_principle — Returns the canonical definition of one of the 9 principles.
• get_anti_pattern — Returns the canonical definition of one of the 8 anti-patterns.
• score_codebase — Deferred-to-local. The Worker can't read your filesystem; use npx -y @capitalthought/agentsfirst-mcp for codebase scoring.

Endpoints

• POST https://agentsfirst.dev/mcp — MCP Streamable HTTP transport (JSON-RPC).
• GET https://agentsfirst.dev/mcp/health — JSON healthcheck.
• GET https://agentsfirst.dev/mcp — this page.

Rules of the road

Read AGENTS.md before calling. The server is read-only — every tool either returns embedded data or makes outbound HTTP fetches against URLs the caller named. Source: github.com/capitalthought/agentsfirst.

agentsfirst-mcp v0.1.0 · 5 tools (4 callable on Worker) · framework: https://agentsfirst.dev