How do I use MCP-MCSTATUS?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP-MCSTATUS Check the status and current player count for mc.hypixel.net" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP-MCSTATUS

MCP server (Python) with tools for https://mcstatus.xyz/api.

Implemented MCP Tools

get_minecraft_status - Minecraft server status (Java/Bedrock), endpoint /api/status
get_java_status - Java status shortcut, endpoint /api/status
get_bedrock_status - Bedrock status shortcut, endpoint /api/status
get_srv_records - SRV records, endpoint /api/srv
resolve_dns - DNS resolution and provider info, endpoint /api/dns
rdns - reverse DNS (PTR) lookup for IP
geoip_maxmind - GeoIP lookup using local MaxMind GeoLite2 database
get_ip_provider_info - provider/operator info for IP via bgp.tools whois + ASN database
is_ip_anycast - check if player IP is Anycast by curated known-node list
get_bgp_info - BGP/ASN details for an IP, endpoint /api/bgp

Architecture

mcstatus_mcp/client.py - typed API client (MCStatusApiClient)
mcstatus_mcp/tools.py - abstract BaseMCStatusTool + one class per MCP tool
mcstatus_mcp/server.py - MCP app bootstrap and tool registration

Each tool is implemented as a class that inherits from BaseMCStatusTool. All tools depend on a shared MCStatusApiClient instance.

Install

.\.venv\Scripts\python.exe -m pip install -r requirements.txt

Run With Docker Compose

docker compose up -d --build

Stop:

docker compose down

Default MCP endpoint from compose:

http://localhost:8000/mcp

Run MCP Server

Default transport is stdio:

.\.venv\Scripts\python.exe main.py

Optional transport override:

$env:MCP_TRANSPORT="sse" .\.venv\Scripts\python.exe main.py

Allowed MCP_TRANSPORT values: stdio, sse, streamable-http.

Local Stdio Config Example

{ "mcpServers": { "mcstatus": { "command": "C:\\Users\\rakse\\PycharmProjects\\MCP-MCSTATUS\\.venv\\Scripts\\python.exe", "args": ["C:\\Users\\rakse\\PycharmProjects\\MCP-MCSTATUS\\main.py"] } } }

Environment Variables

MCP_TRANSPORT - MCP transport (default: stdio)
MCSTATUS_API_BASE_URL - API base URL (default: https://mcstatus.xyz/api)
MCSTATUS_TIMEOUT_MS - default timeout in milliseconds for tools (default: 4000)
MCP_HOST - host for HTTP transports (sse and streamable-http, default: 127.0.0.1)
MCP_PORT - port for HTTP transports (default: 8000)
MCP_STREAMABLE_HTTP_PATH - streamable HTTP path (default: /mcp)
MCP_SSE_PATH - SSE path (default: /sse)
MAXMIND_LICENSE_KEY - MaxMind license key for GeoLite2 download (required for auto-download if DB is missing/outdated)
MAXMIND_DB_PATH - local path to .mmdb file (default: data/GeoLite2-City.mmdb)
MAXMIND_EDITION_ID - MaxMind edition ID (default: GeoLite2-City)
MAXMIND_REFRESH_HOURS - database refresh interval in hours; 0 disables periodic refresh (default: 24)
BGPTOOLS_USER_AGENT - descriptive user-agent with contact for downloading https://bgp.tools/asns.csv (recommended)
BGPTOOLS_ASN_DB_URL - ASN CSV source URL (default: https://bgp.tools/asns.csv)
BGPTOOLS_ASN_DB_PATH - local path to ASN CSV cache (default: data/bgp_tools_asns.csv)
BGPTOOLS_ASN_REFRESH_HOURS - ASN CSV refresh interval in hours; 0 disables periodic refresh (default: 24)
BGPTOOLS_WHOIS_HOST - bgp.tools whois host (default: bgp.tools)
BGPTOOLS_WHOIS_PORT - bgp.tools whois port (default: 43)

Use With OpenAI

Important: OpenAI MCP integration uses remote MCP servers. Local stdio servers are good for local dev/testing, but for OpenAI binding you should expose a public HTTPS endpoint.

1) Run as streamable HTTP for deployment

$env:MCP_TRANSPORT="streamable-http" $env:MCP_HOST="0.0.0.0" $env:MCP_PORT="8000" .\.venv\Scripts\python.exe main.py

After deployment your MCP URL will look like:

https://your-domain.example/mcp

2) Bind MCP server in OpenAI Responses API

from openai import OpenAI client = OpenAI() response = client.responses.create( model="gpt-4.1", tools=[ { "type": "mcp", "server_label": "mcstatus", "server_url": "https://your-domain.example/mcp", "require_approval": "never", "allowed_tools": [ "get_minecraft_status", "get_java_status", "get_bedrock_status", "get_srv_records", "resolve_dns", "rdns", "geoip_maxmind", "get_ip_provider_info", "is_ip_anycast", "get_bgp_info", ], } ], input="Check DNS and Java status for mc.hypixel.net", ) print(response.output_text)