Tyk Mock MCP Server

A comprehensive mock MCP (Model Context Protocol) server built with Go, implementing the November 2025 MCP specification. This server provides a rich set of tools, prompts, and resources for testing and development purposes.

Features

15 Tools Across 6 Categories

👥 User Management

• get_users - Retrieve mock users with filtering options (role, active status)
• create_user - Create new mock users
• update_user - Update existing user data
• delete_user - Delete users by ID

📝 Content Management

• get_posts - Retrieve blog posts with filters (author, status)
• create_post - Create new blog posts

🛒 E-commerce

• get_products - Browse product catalog with filters (category, price range)
• process_order - Process mock orders with inventory management

📊 Analytics & Reports

• get_analytics - Generate analytics data (users, posts, orders, revenue)
• generate_report - Create business reports (sales, users, inventory)

🔧 Utilities

• validate_email - Email validation using regex
• generate_uuid - UUID v4 generation
• format_date - Date formatting (iso, rfc3339, unix, custom)
• get_anything - Echo back request data with real HTTP metadata (client IP, headers) in httpbin.org/anything format

Testing

• slow_response - Respond after a configurable delay (for gateway timeout testing)

SSE Test Endpoints (non-MCP)

• GET /sse/stream - Configurable SSE event stream (event count, pacing, charset)
• GET /sse/crash - SSE stream that crashes after N events (upstream failure simulation)

4 Contextual Prompts

• user_management - User operations guidance
• ecommerce_assistant - E-commerce operations help
• content_management - Blog content management
• analytics_dashboard - Business insights and reporting

3 Data Resources

• users://list - Complete users list (JSON)
• products://catalog - Product catalog (JSON)
• posts://list - Blog posts collection (JSON)

Architecture

The server follows clean architecture principles with clear separation of concerns:

tyk-mock-mcp-server/
├── main.go                    # Server initialization and HTTP setup
├── models/                    # Data models and DTOs
│   ├── user.go
│   ├── post.go
│   ├── product.go
│   ├── order.go
│   ├── analytics.go
│   ├── utilities.go
│   └── common.go
├── store/                     # Data storage layer
│   └── store.go
└── handlers/                  # Business logic handlers
    ├── tools/                 # Tool implementations
    │   ├── users.go
    │   ├── posts.go
    │   ├── ecommerce.go
    │   ├── analytics.go
    │   └── utilities.go
    ├── prompts/              # Prompt handlers
    │   └── prompts.go
    └── resources/            # Resource handlers
        └── resources.go

Requirements

• Go 1.22 or higher
• Docker (optional, for containerized deployment)
• Task (optional, for using Taskfile commands)

Installation

As a Library (For Integration Tests)

You can import this server in your integration tests (e.g., Tyk Gateway tests) to test JSON-RPC/MCP features:

import "github.com/TykTechnologies/tyk-mock-mcp-server/testserver"

func TestMyMCPFeature(t *testing.T) {
    // Start mock MCP server on random port
    mcpServer, cleanup := testserver.StartServer(0)
    defer cleanup()

    // Use mcpServer.URL in your API configuration
    // Access mcpServer.Store for test assertions
}

See testserver/README.md for detailed usage patterns and examples.

As a Standalone Server

Using Go

# Clone the repository
git clone https://github.com/TykTechnologies/tyk-mock-mcp-server.git
cd tyk-mock-mcp-server

# Install dependencies
go mod download

# Build the server
go build -o tyk-mock-mcp-server .

# Run the server
./tyk-mock-mcp-server

Using Task

# Install dependencies and build
task install

# Build the binary
task build

# Run the

... [View full README on GitHub](https://github.com/TykTechnologies/tyk-mock-mcp-server#readme)