ServiceStack MCP Server

Name: ServiceStack MCP Server
Author: ServiceStack

An MCP (Model Context Protocol) Server that enables Claude to interact with ServiceStack APIs. This tool transforms your ServiceStack API metadata into an MCP server, allowing Claude to discover and invoke your APIs through natural language.

What is this?

This MCP server allows Claude to:

Discover all available APIs from your ServiceStack application
Understand the request/response schemas
Invoke APIs with proper parameters
Handle authentication when required

Getting Your ServiceStack API Metadata

ServiceStack automatically generates API metadata at the /metadata/app.json endpoint of your application. You can use this tool in two ways:

Option 1: Use URL Directly (Recommended)

Point directly to your ServiceStack API URL - the tool will automatically fetch the metadata:

# Using base URL (will automatically fetch /metadata/app.json) npx mcp-apis https://your-api.com # Or for local development npx mcp-apis https://localhost:5001 # You can also specify the full metadata path npx mcp-apis https://your-api.com/metadata/app.json

Option 2: Download app.json File

Alternatively, download the metadata file first:

# Download from your ServiceStack application curl https://your-api.com/metadata/app.json > app.json # Or for local development curl https://localhost:5001/metadata/app.json > app.json

Quick Start

You can run the MCP server with either a URL or local file:

# Using a URL (recommended) npx mcp-apis https://your-api.com # Using a local file npx mcp-apis ./app.json

Filtering APIs

Filter by tag:

# With URL npx mcp-apis https://your-api.com --tag Posts # With local file npx mcp-apis ./app.json --tag TechStacks

Filter specific APIs:

# Single API npx mcp-apis https://your-api.com --apis QueryPost # Multiple APIs npx mcp-apis ./app.json --apis QueryPosts,CreatePost,UpdatePost,DeletePost

Connecting to Claude Tools

Claude Desktop App

To use this MCP server with the Claude Desktop app, add it to your Claude Desktop configuration file:

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%/Claude/claude_desktop_config.json

On Linux: ~/.config/Claude/claude_desktop_config.json

Add the following configuration:

Using a URL (recommended):

{ "mcpServers": { "servicestack": { "command": "npx", "args": [ "mcp-apis", "https://your-api.com" ] } } }

Using a local file:

{ "mcpServers": { "servicestack": { "command": "npx", "args": [ "mcp-apis", "/absolute/path/to/your/app.json" ] } } }

Example with filtering:

{ "mcpServers": { "techstacks-api": { "command": "npx", "args": [ "mcp-apis", "https://techstacks.io", "--tag", "Posts" ] } } }

After saving the configuration, restart Claude Desktop. The MCP server will appear in the MCP menu (click the 🔌 icon at the bottom of the chat window).

Claude Code CLI

To use this MCP server with Claude Code, add it to your MCP settings file:

Location: ~/.config/claude-code/mcp_settings.json

Using a URL (recommended):

{ "mcpServers": { "servicestack": { "command": "npx", "args": [ "mcp-apis", "https://your-api.com" ] } } }

Using a local file:

{ "mcpServers": { "servicestack": { "command": "npx", "args": [ "mcp-apis", "/absolute/path/to/your/app.json" ] } } }

Example with filtering:

{ "mcpServers": { "my-api": { "command": "npx", "args": [ "mcp-apis", "https://my-api.com", "--apis", "QueryPosts,CreatePost,UpdatePost" ] } } }

After saving, restart Claude Code. You can verify the MCP server is connected by checking the MCP status in the CLI.

Per-Project Configuration (Claude Code)

For project-specific MCP servers, create a .mcp_settings.json file in your project root:

Using a URL:

{ "mcpServers": { "local-api": { "command": "npx", "args": [ "mcp-apis", "https://localhost:5001" ] } } }

Using a local file:

{ "mcpServers": { "local-api": { "command": "npx", "args": [ "mcp-apis", "./app.json" ] } } }

Claude Code will automatically load this configuration when working in that directory.

Using with Other MCP Clients

Any MCP-compatible client can connect to this server using the stdio transport. The general pattern is:

{ "command": "npx", "args": ["mcp-apis", "/path/to/app.json"] }

Or if you've installed globally:

{ "command": "mcp-apis", "args": ["/path/to/app.json"] }

Configuration Options

All command-line options work in MCP client configurations:

Filter by tag:
"args": ["mcp-apis", "./app.json", "--tag", "Posts"]
Filter specific APIs:
"args": ["mcp-apis", "./app.json", "--apis", "QueryPosts,CreatePost"]
Combine multiple filters:
"args": ["mcp-apis", "./app.json", "--tag", "TechStacks", "--apis", "QueryPosts"]

Example Usage in Claude

Once connected, you can interact with your ServiceStack APIs naturally:

You: "Get the post with ID 123" Claude: [Uses the GetPost API to fetch post 123] You: "Create a new post titled 'Hello World' in organization 1" Claude: [Uses the CreatePost API with the provided parameters] You: "Search for posts about TypeScript" Claude: [Uses the QueryPosts API to search for relevant posts]

Troubleshooting

If the MCP server doesn't appear:

Verify the path: Make sure the path to your app.json file is absolute, not relative
Check the file exists: Ensure your app.json file exists at the specified path
Restart the client: After updating the configuration, restart Claude Desktop or Claude Code
Check logs:
- Claude Desktop: Check ~/Library/Logs/Claude/ (macOS) or equivalent on your OS
- Claude Code: Look for MCP-related errors in the CLI output

ServiceStack MCP Server

ServiceStack MCP Server

What is this?

Getting Your ServiceStack API Metadata

Option 1: Use URL Directly (Recommended)

Option 2: Download app.json File

Quick Start

Filtering APIs

Connecting to Claude Tools

Claude Desktop App

Claude Code CLI

Per-Project Configuration (Claude Code)

Using with Other MCP Clients

Configuration Options

Example Usage in Claude

Troubleshooting

Resources

New MCP Servers

Latest Blog Posts

MCP directory API