g8kepr 1.0.0

G8KEPR API Security Platform - Python SDK

G8KEPR Python SDK

Official Python SDK for the G8KEPR API Security Platform.

Installation

pip install g8kepr

Quick Start

from g8kepr import G8KEPRClient

# Initialize client
client = G8KEPRClient(
    base_url="https://api.g8kepr.com",
    api_key="your-api-key"
)

# Or authenticate with email/password
client.auth.login(email="[e-mail]", password="...")

# List AI agents
agents = client.agents.list()
for agent in agents:
    print(f"Agent: {agent['name']} - Status: {agent['status']}")

# Get recent threats
threats = client.threats.get_recent(limit=10)
for threat in threats:
    print(f"Threat: {threat['type']} - Severity: {threat['severity']}")

# MCP server management
servers = client.mcp.list_servers()

Features

Authentication

# Login
result = client.auth.login("[e-mail]", "password")

# Get current user
user = client.auth.me()

# Refresh token
client.auth.refresh_token()

AI Agents

# List agents
agents = client.agents.list(status="active")

# Create agent
agent = client.agents.create(
    name="MyAgent",
    description="Production agent",
    capabilities=["tool_use", "memory"],
    tools=["read_file", "write_file"]
)

# Update agent
client.agents.update(agent["id"], status="inactive")

# Get interactions
interactions = client.agents.get_interactions(agent["id"])

MCP Security

# List MCP servers
servers = client.mcp.list_servers()

# Register server
server = client.mcp.register_server(
    name="filesystem-server",
    server_type="stdio",
    connection_string="npx @modelcontextprotocol/server-filesystem"
)

# Check permissions
result = client.mcp.check_permission(
    server_id="...",
    tool_name="read_file",
    arguments={"path": "/etc/passwd"}
)
print(f"Allowed: {result['allowed']}, Reason: {result['reason']}")

# Create permission rule
client.mcp.create_permission(
    permission_type="user",
    action="deny",
    tool_name="delete_*",
    priority=100
)

Threat Detection

# Get recent threats
threats = client.threats.get_recent(
    limit=100,
    threat_type="sql_injection",
    blocked_only=True
)

# Get statistics
stats = client.threats.get_stats(period_hours=24)
print(f"Total threats: {stats['total']}")
print(f"Blocked: {stats['blocked']}")

# Block IP
client.threats.block_ip(
    ip_address="192.168.1.100",
    reason="Repeated SQL injection attempts",
    duration_hours=24
)

Dashboard

# Get overview
overview = client.dashboard.get_overview()

# Get metrics
metrics = client.dashboard.get_metrics(period="7d", granularity="day")

# Get security score
score = client.dashboard.get_security_score()
print(f"Security Score: {score['overall']}/100")

Error Handling

from g8kepr import G8KEPRClient
from g8kepr.exceptions import (
    AuthenticationError,
    RateLimitError,
    NotFoundError,
    ValidationError,
)

client = G8KEPRClient(base_url="https://api.g8kepr.com")

try:
    client.auth.login("[e-mail]", "wrong_password")
except AuthenticationError as e:
    print(f"Login failed: {e.message}")

try:
    client.agents.get("nonexistent-id")
except NotFoundError as e:
    print(f"Agent not found: {e.message}")

try:
    # Rapid requests
    for i in range(1000):
        client.threats.get_recent()
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after} seconds")

Context Manager

# Automatic cleanup
with G8KEPRClient(base_url="...", api_key="...") as client:
    agents = client.agents.list()

Requirements

• Python 3.8+
• httpx >= 0.24.0

License

Copyright (c) 2024-2025 Wesley Ellis. All Rights Reserved.