Skip to main content

pydantic-ai-helve

PydanticAI capability and MCP connection helper for Helve — a pay-per-call AI tool gateway exposing 313 live tools across 255 providers (web search, batch extraction, audio transcription, PDFs, LLMs, finance, email, and more) behind one API key.

  • No monthly subscriptions: Prepaid USD 10, USD 25, or USD 100 credit packs that never expire.
  • Deterministic spend caps: Set per-key spend_limit_usd limits (402 spend_limit_exceeded before overspend).
  • Zero charge on failed calls: Upstream errors or timeouts are refunded automatically.
  • MCP + REST / Code Mode ready: Use HelveCapability over REST or connect directly to https://helve.dev/mcp via helve_mcp_server().

Installation

pip install pydantic-ai-helve

Quickstart (Capability)

import asyncio
from pydantic_ai_helve import HelveCapability

async def main() -> None:
    helve = HelveCapability()  # reads HELVE_API_KEY from environment

    # 1. Discover matching tools, schemas, and pricing hints (no auth required)
    results = await helve.search_tools("web page extraction", limit=3)
    print(results)

    # 2. Call any discovered tool_id with its native input_schema
    extracted = await helve.call_tool(
        "helve.web_extract",
        {
            "urls": ["https://docs.helve.dev"],
            "content": {"max_chars": 4000},
        },
    )
    print(extracted)

asyncio.run(main())

Quickstart (PydanticAI Streamable HTTP MCP)

from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStreamableHTTP
from pydantic_ai_helve import helve_mcp_server

cfg = helve_mcp_server()  # reads HELVE_API_KEY from environment
server = MCPServerStreamableHTTP(url=cfg["url"], headers=cfg["headers"])
agent = Agent("openai:gpt-4o", toolsets=[server])

Metadata

Release files for pydantic-ai-helve 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pydantic-ai-helve 0.1.0
File Size Uploaded Provenance Actions
pydantic_ai_helve-0.1.0.tar.gz 4.1 kB Without provenance Details for pydantic_ai_helve-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pydantic-ai-helve 0.1.0
File Interpreter ABI Platform Actions
pydantic_ai_helve-0.1.0-py3-none-any.whl Python 3 none any Details for pydantic_ai_helve-0.1.0-py3-none-any.whl

Total release size: 8.1 kB

Release files / pydantic_ai_helve-0.1.0.tar.gz

Download URL pydantic_ai_helve-0.1.0.tar.gz
Size 4.1 kB
Tags Source
SHA-256 checksum
How to use checksums
e60e2859058dfa70a8c61d945cdf3de97fba2455841511db213a86a97292e613
BLAKE2b-256 checksum
How to use checksums
da158d5c1aa4bce333f1e8e106a642bad53f2a28969fe31392a03a1f104fea31
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.2

Release files / pydantic_ai_helve-0.1.0-py3-none-any.whl

Download URL pydantic_ai_helve-0.1.0-py3-none-any.whl
Size 4.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3b1dd19a0ef041c7442823b398140a5abe46b63cb875da3568e0003c00010a5a
BLAKE2b-256 checksum
How to use checksums
d7694e950f10b44e9e9e3cfefb34416d4d6ba53251bbd9ebc84693c7de2f8e9f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.2

Security for pydantic-ai-helve 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page