pydantic-ai-strale

Pydantic AI integration for Strale — 250+ independently tested and scored business data capabilities for AI agents.

Strale provides IBAN validation, VAT validation, company data across 27 countries, sanctions screening, compliance checks (KYB, AML, GDPR), invoice extraction, SSL certificate checks, and more. Every capability is quality-scored with the Strale Quality Score (SQS).

Installation

pip install pydantic-ai-strale

Quick Start

from pydantic_ai import Agent
from pydantic_ai_strale import StraleClient

strale = StraleClient(api_key="sk_live_...")

agent = Agent("openai:gpt-4o")

@agent.tool_plain
def validate_iban(iban: str) -> dict:
    """Validate an IBAN number. Returns validity, country, bank BIC, bank name."""
    return strale.run("iban-validate", {"iban": iban})

@agent.tool_plain
def check_sanctions(name: str, country: str = "") -> dict:
    """Screen a name against global sanctions lists (OFAC, EU, UN)."""
    inputs = {"name": name}
    if country:
        inputs["country"] = country
    return strale.run("sanctions-check", inputs)

@agent.tool_plain
def lookup_company(org_number: str) -> dict:
    """Look up Swedish company data by organization number."""
    return strale.run("swedish-company-data", {"org_number": org_number})

Multiple Capabilities

from pydantic_ai_strale import StraleClient

strale = StraleClient(api_key="sk_live_...")

# List all capabilities
caps = strale.list_capabilities()
print(f"{len(caps)} capabilities available")

# Filter by category
compliance_caps = strale.list_capabilities(category="compliance")
for cap in compliance_caps:
    print(f"  {cap['slug']} — €{cap['price_cents']/100:.2f}")

Capability Categories

Full list: strale.dev/capabilities

Free Tier

5 capabilities work without an API key or signup: email-validate, dns-lookup, json-repair, url-to-markdown, iban-validate.

MCP Alternative

If your agent framework supports MCP, you can use Strale's MCP server directly — no wrapper package needed:

• Endpoint: https://api.strale.io/mcp
• Transport: Streamable HTTP
• npm package: strale-mcp

Trust & Quality

Every Strale capability has a quality score (SQS) combining:

• Quality Profile: correctness, schema compliance, error handling, edge cases
• Reliability Profile: availability, success rate, upstream health, latency

Scores and methodology: strale.dev/trust

Using Strale in agent system prompts

Add this to your Pydantic AI agent's system prompt for automatic capability routing:

When you need to verify a business, validate an IBAN or VAT number, screen
against sanctions/PEP lists, extract data from a URL or document, or check
compliance — use your Strale tools. Call strale_search to find the right
capability, then call it by name. Returns structured JSON with quality scores.
250+ capabilities across 27 countries. Free tier: email-validate, dns-lookup,
json-repair, url-to-markdown, iban-validate (no API key needed).

Links

• Homepage
• Documentation
• Capabilities
• Pricing
• GitHub
• MCP Server Card