Metadata-Version: 2.5
Name: semantic-kernel-surface
Version: 0.1.0
Summary: Surface for Semantic Kernel: 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: ai-agents,kernel-function,link-safety,mcp,preflight,semantic-kernel,sk-plugin,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: semantic-kernel>=1.0
Description-Content-Type: text/markdown

# semantic-kernel-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 Semantic Kernel agents that check as one ready-made tool: `surface_preflight`.

```bash
pip install semantic-kernel-surface
```

```python
from semantic_kernel import Kernel
from semantic_kernel_surface import SurfacePlugin

kernel = Kernel()
kernel.add_plugin(SurfacePlugin(), plugin_name="surface")
```

## 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.
