# GodPrompt MCP Server

> GodPrompt MCP Server is an open-source MCP server for ai models and llm tooling. MCP server serving the GodPrompt coding workflow: task routing, gates and protocols. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Website:** https://tomiseregi.si/projects/god-prompt
- **Repository:** https://github.com/akzar1el/god-prompt-mcp
- **MCP Registry name:** io.github.AKzar1el/god-prompt-mcp
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-14

## About

Instead of putting a long system prompt in every session, this server hands out pieces of one engineering workflow on request. A cheap call classifies the task into one of nine types (build, debug, refactor, content, design, ship, analyze, automate, plan), and further calls load protocols, verification gates or anti-pattern guidance only when needed.

The maintainer is candid about limits: the benchmark comparing output with and without GodPrompt has not been published, so no quality uplift is claimed. The server only distributes the content; the evaluation tooling lives in the core repository.

It runs locally over stdio from npm or an mcpb bundle, or as a hosted read-only Streamable HTTP endpoint with no key.

## Features

- **Task classification:** Deterministically maps a task to one of nine types or UNCLASSIFIED.
- **Progressive loading:** Start with the core skill and load deeper files only when required.
- **Verification gates:** Checklists to satisfy before claiming a fix is done.
- **Hosted or local:** Use the public HTTP endpoint or run it over stdio.
- **Single-file option:** One call returns the full combined prompt.

## Good for

- Route a refactor to the right workflow before starting
- Load the debugging protocol for a failing test
- Check verification gates before reporting a fix
- Keep agent context small while still using detailed guidance

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http god-prompt-mcp https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "god-prompt-mcp": {
      "url": "https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "god-prompt-mcp": {
      "type": "http",
      "url": "https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "god-prompt-mcp": {
      "serverUrl": "https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "god-prompt-mcp": {
      "type": "http",
      "url": "https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp"
    }
  }
}
```

## Tools

- `get_god_prompt`: Returns the complete GodPrompt.md — a single-file universal system prompt for AI software development (63KB, ~1145 lines). Use this when you want the full payload in one shot. For progressive disclosure (smaller context), use get_core_skill and the reference tools instead.
- `get_core_skill`: Returns SKILL.md — the lean core protocol (~32KB) covering the universal 6-phase protocol, Three Iron Laws, and task auto-classification. Load it at the start of a task or after a context reset, then reuse that context instead of reloading it on every message. Start here for progressive disclosure.
- `get_protocols`: Returns references/01-PROTOCOLS.md — deep execution guides for each task type (BUILD, DEBUG, REFACTOR, CONTENT, DESIGN, SHIP, ANALYZE, AUTOMATE, PLAN). Load this when the task requires detailed protocol steps beyond the core skill. ~13KB.
- `get_gates`: Returns references/02-GATES.md — verification checklists, THE GATE (pre-completion verification), and structured report templates for every deliverable type. Load when you need to verify work before claiming completion. ~9KB.
- `get_anti_patterns`: Returns references/03-ANTI-PATTERNS.md — red flags, rationalizations, and recovery patterns. Covers the 10 most dangerous anti-patterns that lead to broken code, scope creep, and false confidence. Load when you catch yourself rationalizing. ~9KB.
- `classify_task`: Classify one concrete software-development task into one of GodPrompt's 9 task types (BUILD, DEBUG, REFACTOR, CONTENT, DESIGN, SHIP, ANALYZE, AUTOMATE, PLAN), or UNCLASSIFIED when no reliable route is detected. Returns JSON with task_type, deterministic confidence, protocol, matched_signals, alternative_task_types, ambiguous, and recommendation; use it for routing before loading detailed workflow 
- `get_version`: Returns JSON with the GodPrompt content version, MCP server version, repository, bundled file sizes and purposes, and task-type/protocol catalog. Use it to verify which GodPrompt content/server version a client is connected to; use the content retrieval tools when you need the actual workflow text.

## FAQ

### Is it free?

The MIT-licensed server is free. A separate US$49 Agent Harness Review is sold through GitHub Sponsors.

### Does it need an API key?

No, the hosted endpoint requires no key.

### Is there proof it improves output?

The maintainer says no benchmark run has been published yet.

### Is GodPrompt MCP Server free?

Yes. GodPrompt MCP Server is open source, so you can use and self-host it for free.

### How do I add GodPrompt MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http god-prompt-mcp https://god-prompt-mcp.tomi-seregi99.workers.dev/mcp

### What are the best alternatives to GodPrompt MCP Server?

The closest alternatives to GodPrompt MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/godprompt-mcp-server
