mock-llm-mcp

MCP server for Mock LLM API — mock OpenAI, Anthropic, and Google Gemini responses for testing AI integrations. No real API keys or token spend required.

Installation

pip install mock-llm-mcp
# or
uvx mock-llm-mcp

Related MCP server: Outsource MCP

Claude Desktop Configuration

{
  "mcpServers": {
    "mock-llm": {
      "command": "uvx",
      "args": ["mock-llm-mcp"],
      "env": {
        "MOCK_LLM_API_KEY": "your-key-here"
      }
    }
  }
}

No API key required for the free tier (500 calls/day). Get a key at rebaselabs.online for higher limits.

Tools

Use Cases

• Test without token spend — verify your LLM integration code works without calling real APIs

• CI/CD pipelines — deterministic, offline-safe tests using seed-based responses

• Error handling — simulate rate limits, 500 errors, auth failures, context length exceeded

• Frontend dev — build chat UIs without a real API key

• Multi-provider testing — test your abstraction layer against OpenAI, Anthropic, and Google formats

Examples

Quick mock (no format needed)

mock_quick(prompt="Explain quantum computing", length="short")

Test OpenAI integration

mock_openai_chat(
    messages=[{"role": "user", "content": "Hello!"}],
    model="gpt-4o",
    response_type="text"
)

Simulate a rate limit error

mock_simulate_error(provider="anthropic", error_type="rate_limit")

Deterministic response with seed

mock_quick(prompt="Write a haiku", seed=42)

Response Control Headers

All mock tools support:

• length: "short", "medium", "long", "xl", "random"

• response_type: "auto", "text", "code", "json", "markdown", "list"

• error: "none", "rate_limit", "server_error", "timeout", "invalid_key", "context_length", "content_filter"

• delay_ms: 0–5000 — artificial latency

• seed: integer — reproducible responses

Environment Variables

Part of the RebaseKit Agent Infrastructure Stack

Mock LLM MCP is part of the RebaseKit suite of agent-native APIs:

• WeTask — web extraction & browser automation

• CodeExec — sandboxed code execution

• PII API — detect & mask sensitive data

• DocParse — document parsing & OCR

• DataTransform — data format conversion & querying

• Mock LLM — mock any LLM provider for testing

"The internet was built for humans. RebaseKit makes it work for agents."