Metadata-Version: 2.5
Name: openai-agents-surface
Version: 0.1.0
Summary: Surface for OpenAI Agents SDK: 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: agents-sdk,ai-agents,link-safety,mcp,openai,openai-agents,preflight,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: openai-agents>=0.1
Description-Content-Type: text/markdown

# openai-agents-surface

Surface is the link-safety layer between an AI agent and the open web. One tool, `surface_preflight`: give it a URL, get `fetch` or `skip` plus where the link really goes (unwraps t.co, bit.ly, redirects).

```python
from agents import Agent
from openai_agents_surface import surface_preflight

agent = Agent(name="web", 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.
