🐍 Quota Python SDK (quota-sdk)

🇺🇸 English | 🇧🇷 Português

🇺🇸 English

Official Python SDK for Quota: Unified LLM Observability, Real-time Cost Tracking, Proxy & native Model Context Protocol (MCP) tool interception for Python applications and agents.

🎯 Supported AI Providers

The Quota platform supports and monitors all models from the following AI providers:

• OpenAI
• Anthropic
• Google
• Groq
• Mistral

🚀 Installation

pip install quota-sdk

⚙️ Quickstart

from quota import Quota

# 1. Initialize Quota
Quota.init(
    api_key="quota_live_YOUR_API_KEY",
    endpoint="https://api.quota.ai/collector",  # Optional (default: official endpoint)
    project="ecommerce-portal",
    agent="customer-support-bot",
    environment="production",
    debug=False
)

🧠 Model Context Protocol (MCP) Integration

Option A: Wrap an MCP Client

from quota import Quota

# Wrap any Python MCP Client
mcp_client = Quota.wrap_mcp(my_raw_mcp_client, tags=["mcp", "db-tools"])

# Calls to call_tool are transparently intercepted and logged to Quota!
result = mcp_client.call_tool(name="query_orders", user_id="usr_123")

Option B: Functional Interceptor

from quota import Quota

response = Quota.intercept_mcp(
    action=lambda: call_my_ai_function(),
    provider="anthropic",
    tags=["mcp-action"]
)

Manual Tracking

from quota import Quota

Quota.track_usage({
    "provider": "google",
    "model": "gemini-model",
    "promptTokens": 120,
    "completionTokens": 35,
    "cachedTokens": 20,
    "latencyMs": 410,
    "statusCode": 200,
    "success": True,
    "metadata": {
        "project": "bi-reports",
        "agent": "analyst-bot"
    }
})

🇧🇷 Português

SDK oficial em Python do Quota: Observabilidade unificada de LLMs, monitoramento de custos em tempo real, proxy e interceptação nativa de ferramentas do Model Context Protocol (MCP) para aplicações e agentes em Python.

🎯 Provedores de IA Suportados

A plataforma Quota suporta e monitora modelos dos seguintes provedores:

• OpenAI
• Anthropic
• Google
• Groq
• Mistral

🚀 Instalação

pip install quota-sdk

⚙️ Inicialização Rápida

from quota import Quota

Quota.init(
    api_key="quota_live_sua_chave_aqui",
    endpoint="https://sua-api.com/collector",  # Opcional (padrão: rota oficial)
    project="portal-vendas",
    agent="assistente-atendimento",
    environment="production"
)

🧠 Integração com Model Context Protocol (MCP)

Opção A: Envelopando um Cliente MCP

from quota import Quota

# Envelopa qualquer cliente MCP em Python
mcp_client = Quota.wrap_mcp(meu_mcp_client, tags=["mcp", "ferramentas-db"])

# As chamadas a call_tool são automaticamente interceptadas e gravadas no Quota!
resultado = mcp_client.call_tool(name="consultar_pedidos", user_id="usr_123")

Opção B: Interceptador Funcional

from quota import Quota

resposta = Quota.intercept_mcp(
    action=lambda: minha_funcao_ia(),
    provider="openai",
    tags=["mcp-action"]
)

Envio Manual de Telemetria

from quota import Quota

Quota.track_usage({
    "provider": "google",
    "model": "gemini-model",
    "promptTokens": 120,
    "completionTokens": 35,
    "cachedTokens": 20,
    "latencyMs": 410,
    "statusCode": 200,
    "success": True,
    "metadata": {
        "project": "relatorios-bi",
        "agent": "bot-analista"
    }
})

📄 Licença / License

MIT © Quota