Metadata-Version: 2.5
Name: pydantic-ai-surface
Version: 0.1.0
Summary: Surface for Pydantic AI: the link-safety layer between an AI agent and the open web. One tool, surface_preflight, that tells your agent whether a link is worth fetching.
Project-URL: Homepage, https://otter-sand-wolf-spring.grok.me
Project-URL: Documentation, https://nova-otter-delta-cloud.grok.me/docs
Project-URL: API reference, https://nova-otter-delta-cloud.grok.me/llms.txt
Project-URL: MCP server, https://nova-otter-delta-cloud.grok.me/mcp
Author-email: Canada Site Ops <canada.site.ops@gmail.com>
Maintainer-email: Canada Site Ops <canada.site.ops@gmail.com>
License: MIT
License-File: LICENSE
Keywords: agent-tool,ai-agents,link-safety,mcp,preflight,pydantic,pydantic-ai,surface,tools,url
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Requires-Dist: pydantic-ai-slim>=0.1
Description-Content-Type: text/markdown

# pydantic-ai-surface

**Surface is the link-safety layer between an AI agent and the open web.** Before your agent opens a link someone pasted, Surface checks it: it unwraps short links (t.co, bit.ly, lnkd.in, youtu.be), follows the redirects, and answers **fetch** or **skip**, along with where the link really goes. It never downloads the page for you, so it's fast and cheap. If Surface can't be reached, the tool answers skip, so your agent stays safe.

This package gives Pydantic AI agents that check as one ready-made tool: `surface_preflight`.

```bash
pip install pydantic-ai-surface
```

```python
from pydantic_ai import Agent
from pydantic_ai_surface import surface_preflight

agent = Agent("openai:gpt-4o", tools=[surface_preflight])
```

## Free to start

The first 1M requests a month are free. It works with no key at all (shared demo limit), or grab your own free key in one call, with no email and no card:

```bash
curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
export SURFACE_API_KEY=...
```

After the free tier: $0.25 USD per 1,000 preflights.

## Prefer MCP?

Point any MCP client at `https://nova-otter-delta-cloud.grok.me/mcp` (tool `preflight_url`).

- Website: https://otter-sand-wolf-spring.grok.me
- Docs: https://nova-otter-delta-cloud.grok.me/docs
- LLM reference: https://nova-otter-delta-cloud.grok.me/llms.txt

Made by Canada Site Ops. MIT licensed.
