Multicorn Shield - Python Client

Python client for Multicorn Shield, the open-source AI agent governance platform.

Install

pip install multicorn-shield

Quick start

from multicorn_shield import ShieldClient

client = ShieldClient(api_key="mcs_your_key_here")

result = client.log_action(
    agent_id="your-agent-uuid",  # from the dashboard or list_agents()
    service="gmail",
    action_type="send_email",
    cost=2,  # 2 cents
    metadata={"recipient": "user@example.com"},
)

print(result.status)  # APPROVED, BLOCKED, PENDING, etc.

The client also works as a context manager:

with ShieldClient(api_key="mcs_your_key_here") as client:
    agents = client.list_agents()
    for agent in agents:
        print(f"{agent.name} ({agent.status})")

Async usage

import asyncio
from multicorn_shield import AsyncShieldClient

async def main():
    async with AsyncShieldClient(api_key="mcs_your_key_here") as client:
        result = await client.log_action(
            agent_id="your-agent-uuid",  # from the dashboard or list_agents()
            service="gmail",
            action_type="send_email",
        )
        print(result.status)

asyncio.run(main())

API methods

Both ShieldClient and AsyncShieldClient expose the same methods. The async variant returns coroutines.

TypeScript SDK

The TypeScript SDK has additional features not yet available in the Python client:

• Consent screens (Shadow DOM web component)
• MCP adapter (middleware for MCP tool call interception)
• MCP proxy (wrap any MCP server with zero code changes)
• Client-side spending enforcement with integer-cents arithmetic

Documentation

Full docs at multicorn.ai/shield.

Licence

MIT - Multicorn AI Pty Ltd