home / mcp / world miniapps mcp server

World MiniApps MCP Server

Provides an MCP server to query World Mini Apps docs and integrate with Cursor for interactive development.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "0xzap-worldminiapp_mcp": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

This MCP server lets you query World Mini Apps documentation and integrate it with Cursor, enabling you to fetch world docs on demand and use them to inform your World MiniApp development inside Cursor.

How to use

You will run a local MCP server that serves World MiniApps documentation to your Cursor workspace. Enable the MCP integration in Cursor, point Cursor to the local server, and then chat with an agent that queries the World MiniApps docs when you ask questions. The agent can fetch relevant docs on demand and help you code your World MiniApp with Cursor.

How to install

Prerequisites and setup steps are shown below. Follow them in order to get a working MCP server and Cursor integration.

# Prerequisites
- Python 3
- Cursor installed on your system

# 1. Setup Your Python Environment
python3 -m venv .venv
source .venv/bin/activate

# 2. Install Dependencies
pip install langchain_community langchain-openai langchain-anthropic scikit-learn bs4 pandas pyarrow matplotlib lxml langgraph "mcp[cli]" tiktoken

# 3. Build the Documentation Vector Store
export OPENAI_API_KEY="your-openai-api-key"
python3 worldMiniApp-MCP/miniApp_build_docs.py

# 4. Run the MCP Server
python3 worldMiniApp-MCP/miniApp_mcp.py

# 5. Configure Cursor to Use Your MCP Server
# In Cursor Settings > MCP, add the following configuration block and save
{
  "mcpServers": {
    "world-mini-app-mcp": {
      "command": "your-absolute-path-to-repo-folder/WorldMCP/.venv/bin/python",
      "args": [
        "your-absolute-path-to-repo-folder/WorldMCP/worldMiniApp-MCP/miniApp_mcp.py"
      ],
      "env": {
        "OPENAI_API_KEY": "sk-xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

# 6. Start using the MCP server in Cursor
# Switch Cursor to Agent mode and chat with it. The agent will use world_mini_app_query_tool to fetch docs as needed.

Additional notes

Environment keys shown above include OPENAI_API_KEY. Keep this key secret and do not commit it to source control. Cursor will detect your configured MCP server once you save the configuration, and you can begin conversations with the agent to retrieve World MiniApps documentation and guidance.

Optional steps include using an inspector to manually verify the MCP server during development. If you need to inspect, you can install the inspector tool and run it to connect to your MCP server.

Security and testing considerations

Only expose your MCP server within trusted environments. Use separate API keys for testing and production where possible, and rotate keys regularly. Validate that the server can access the World MiniApps docs vector store and that Cursor can successfully query it through the agent.

Available tools

miniApp_build_docs

Builds the World MiniApps documentation vector store from the docs, preparing data for fast querying by the MCP server.

miniApp_mcp

MCP server executable that handles MCP requests over stdio and serves World MiniApps documentation queries to clients such as Cursor.

mcp_inspector

A tool to manually inspect MCP servers during development to verify endpoints and request handling.