FFakeMCP
Reliability Pack

Catch production agent regressions before users do.

Choose a service and failure mode, run it instantly, then paste the generated cURL into CI.

Scenario Details

Simulates token bucket exhaustion and retry-after hints.

Command Format

Focus: `/` • Run: `Ctrl/Cmd+Enter`

    Core Features

    Replay Fixtures

    Snapshot any run into an immutable artifact. Reproduce exact failures with the same seeds and payloads, weeks later.

    Assertions & Gates

    Attach status codes, retryability, latency, and detail checks to every test case. Catch regressions before they ship.

    CI Gate

    Create runs from suites or inline cases. Export JSON and JUnit reports. Fail builds automatically when error-level assertions fail.

    Protocol Conformance + Stateful Flows

    Validate MCP protocol handshakes and tool invocations. Simulate multi-step flows like token expiry and outage ramps.

    Fake Service Catalog

    github

    Fake GitHub

    Repository events, issues, pull requests, and webhook retries.

    slack

    Fake Slack

    Channels, threads, mentions, and permission edge cases.

    notion

    Fake Notion

    Databases, rich text payloads, and schema drift scenarios.

    postgres

    Fake Postgres

    Transactional behavior, lock contention, and timeout modes.

    stripe

    Fake Stripe

    PaymentIntents, idempotency keys, declines, and API error modes.

    anthropic

    Fake Anthropic

    Messages API, request-id headers, and model overload/rate-limit behaviors.

    twilio

    Fake Twilio

    Programmable Messaging send flows, RestException payloads, and concurrency limits.

    sendgrid

    Fake SendGrid

    Mail send flows, bearer auth failures, and errors[] response envelopes.

    gitlab

    Fake GitLab

    Issues API create flows, token auth failures, and rate-limit response headers.

    jira

    Fake Jira

    Issue creation flows, ErrorCollection payloads, and rate-limit headers.

    hubspot

    Fake HubSpot

    CRM contacts create flows, validation errors, and HubSpot rate-limit headers.

    asana

    Fake Asana

    Task creation flows, errors[] payloads, and retry-after rate limiting.

    msgraph

    Fake Microsoft Graph

    To Do task create flows, OData error envelopes, and throttling retry hints.

    s3

    Fake AWS S3

    REST XML errors, request IDs, and object listing edge cases.

    dynamodb

    Fake DynamoDB

    Provisioned throughput throttling, validation failures, and Query responses.

    sqs

    Fake AWS SQS

    Queue send/receive flows, request throttling, and XML error envelopes.

    Included Scenarios

    Rate Limited
    Auth Expired
    Partial Outage
    Malformed Payload
    Slow Response

    Quickstart

    Terminal
    # Install and start the local MCP server$ pnpm install$ pnpm --filter @fakemcp/mcp dev # Run an inline reliability check$ curl -X POST http://127.0.0.1:8787/v1/runs \  -H "Content-Type: application/json" \  -d '{"source":"ci","cases":[{"server":"github","scenario":"rate_limit"}]}'

    Guides