Metadata-Version: 2.4
Name: surfaceapi
Version: 0.1.0
Summary: Tiny client for Surface: usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP).
Author-email: Surface / Canada Site Ops <canada.site.ops@gmail.com>
License: MIT
Project-URL: Homepage, https://nova-otter-delta-cloud.grok.me
Project-URL: Source, https://github.com/Surface-ops/surface
Keywords: surface,mcp,agents,preflight,link-check,api
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Surface clients

[![Surface](https://nova-otter-delta-cloud.grok.me/badge/surface.svg)](https://nova-otter-delta-cloud.grok.me)

Tiny clients for [Surface](https://nova-otter-delta-cloud.grok.me): usage-priced infrastructure for machine traffic (preflight, hop, pixel, inspect, MCP, badge). First 1M requests/month free.

- JavaScript: `npm install surfaceapi` ([clients/js](js))
- Python: `pip install surfaceapi` ([clients/python](python))

## MCP
Add Surface to any MCP client:
```json
{ "mcpServers": { "surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp" } } }
```

## Python
```python
from surfaceapi import Surface
key = Surface().create_key().get("key")   # free key
s = Surface(api_key=key)
print(s.preflight("https://example.com"))
print(s.inspect())
```
