Installation

Python

Install using pip:

pip install mcp-rank

Or with poetry:

poetry add mcp-rank

Requirements

Python 3.9+
httpx for async HTTP requests
openai or anthropic (optional, for Agent class)

Configuration

Environment Variables

Set your API key as an environment variable:

export MCP_RANK_API_KEY="sk_mcp_rank_..."

Using .env Files

Create a .env file in your project root:

MCP_RANK_API_KEY=sk_mcp_rank_...

Load it in your code:

from dotenv import load_dotenv
load_dotenv()

Direct Configuration

Or pass the API key directly:

from mcp_rank import MCPRankClient

client = MCPRankClient(
    api_key="sk_mcp_rank_...",
    base_url="https://api.mcprank.com",  # optional
    timeout=30.0,  # optional
)

Verify Installation

Test that everything works:

import asyncio
from mcp_rank import MCPRankClient

async def test():
    async with MCPRankClient(api_key="sk_mcp_rank_...") as client:
        health = await client.health()
        print(f"API Status: {health['status']}")
        print(f"Server Count: {health['server_count']}")

asyncio.run(test())

Expected output:

API Status: healthy
Server Count: 490

​Installation

​Python

​Requirements

​Configuration

​Environment Variables

​Using .env Files

​Direct Configuration

​Verify Installation