agentpass-sdk

AgentPass Python SDK

The credit check for AI agents -- trust scoring, signed payments, AML sanctions screening.

Installation

pip install agentpass-sdk

Quick Start

from agentpass import AgentPassClient, register

# Register a new account
result = register("dev@example.com", "Your Name", "password", company="Acme Inc")
api_key = result["apiKey"]

# Create a client
client = AgentPassClient(api_key=api_key)

# Create an agent
agent = client.create_agent("payment-bot", scope=["payments"])
agent_id = agent["id"]

# Check trust score
trust = client.get_trust(agent_id)
print(f"Trust score: {trust['score']}")

# Make a payment
tx = client.pay(agent_id, to="store.example.com", amount=1000, currency="usd")
print(f"Transaction: {tx['transactionId']}")

# Screen against sanctions lists
check = client.screen_sanctions("ACME Corp", country="GB")
print(f"Sanctioned: {check['matched']}")

# Check balance
bal = client.balance()
print(f"Balance: {bal['balance']} cents")

Async Usage

import asyncio
from agentpass import AsyncAgentPassClient

async def main():
    async with AsyncAgentPassClient(api_key="apt_live_xxx") as client:
        agents = await client.list_agents()
        trust = await client.get_trust("agt_123")
        tx = await client.pay("agt_123", "store.example.com", 500)

asyncio.run(main())

Identity Verification (Challenge-Response)

Prove an agent's identity using ECDSA P-256 challenge-response:

# Requires: pip install cryptography
result = client.prove_identity(agent_id, private_key_pem)
print(f"Verified: {result['verified']}")

Or step-by-step:

challenge = client.get_challenge(agent_id)
signature = client.sign_challenge(challenge["challenge"], private_key_pem)
result = client.verify_identity(agent_id, challenge["challenge"], signature)

Agent-to-Agent Payments

tx = client.agent_pay(
    from_agent_id="agt_sender",
    to_agent_id="agt_receiver",
    amount=500,
    currency="usd",
    description="Service fee"
)

All Methods

Error Handling

from agentpass import (
    AgentPassError,
    AuthenticationError,
    InsufficientFundsError,
    TrustLimitError,
    NotFoundError,
    ReplayError,
)

try:
    client.pay(agent_id, "store", 5000)
except InsufficientFundsError:
    print("Top up your wallet first")
except TrustLimitError:
    print("Agent trust score too low")
except AuthenticationError:
    print("Invalid API key")
except AgentPassError as e:
    print(f"Error {e.status}: {e}")

Links

• Website: https://agentpass.co.uk
• Documentation: https://agentpass.co.uk/docs

License

MIT -- (c) 2026 CyberSecAI Ltd.