Surface: check a short link before your agent opens it
Your agent gets a t.co, bit.ly, lnkd.in or youtu.be link and has no idea where it goes. Surface follows the hops and says fetch or skip. It never returns the page, so it's one quick round trip.
Power your agent
URL ของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
https://nova-otter-delta-cloud.grok.me/mcpปุ่ม Claude ด้านบนจะเปิด Claude พร้อมกรอกชื่อและ URL ให้แล้ว คุณยังต้องยืนยันที่นั่นเอง
claude mcp add --transport http me.grok.nova-otter-delta-cloud-surface https://nova-otter-delta-cloud.grok.me/mcpRun in a terminal.
{ "mcpServers": { "me.grok.nova-otter-delta-cloud-surface": { "command": "npx", "args": [ "-y", "mcp-remote", "https://nova-otter-delta-cloud.grok.me/mcp" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Your agent gets a t.co, bit.ly, lnkd.in or youtu.be link and has no idea where it goes. Surface follows the hops and says fetch or skip. It never returns the page, so it's one quick round trip.
Preflight a short or unknown URL before your agent fetches it. Returns next: fetch or skip.
Clients: npm install @surfaceapi/surface · pip install surfaceapi
Under the hood, Surface is a remote MCP server and HTTP API (next: "fetch" or next: "skip").
This repo contains:
https://nova-otter-delta-cloud.grok.me/mcppreflight_url { "url": "https://..." }me.grok.nova-otter-delta-cloud/surfaceGet a free API key (optional, 10 seconds, no card):
curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys
# -> {"key":"surf_..."}
export SURFACE_KEY=surf_...
Or use the sign-up page: https://nova-otter-delta-cloud.grok.me/start#key. Send the key as Authorization: Bearer $SURFACE_KEY (or X-Surface-Key: $SURFACE_KEY). Check your usage with GET /v1/usage. Keyless calls still work, but they are limited to 60 per minute and include a get_key note.
Claude Code
claude mcp add --transport http surface https://nova-otter-delta-cloud.grok.me/mcp --header "Authorization: Bearer $SURFACE_KEY"
Without a key, drop the --header part.
Cursor (.cursor/mcp.json)
{ "mcpServers": { "surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp", "headers": { "Authorization": "Bearer surf_..." } } } }
The headers block is optional.
See examples/mcp-clients.md for VS Code, Codex and Claude Desktop.
Requires Node.js 18 or later. No dependencies.
git clone https://github.com/Surface-ops/surface && cd surface
npm test # offline tests
node bin/surface-mcp.js # stdio MCP server (JSON-RPC on stdin/stdout)
node bin/surface-preflight.js https://bit.ly/example --json
Or without cloning:
{ "mcpServers": { "surface": { "command": "npx", "args": ["-y", "github:Surface-ops/surface"] } } }
Environment:
SURFACE_KEY: optional. Your free surf_… key from POST /v1/keys or /start#key, sent as Authorization: Bearer …. SURFACE_API_KEY is still accepted. Without a key, calls use the shared keyless tier (60 per minute).SURFACE_BASE_URL: optional. It defaults to https://nova-otter-delta-cloud.grok.me.import { preflight, mcpPreflight, shouldFetch } from "surface-mcp"; // or "./src/client.js"
const v = await preflight("https://bit.ly/example");
if (shouldFetch(v)) await fetch(v.final_url);
# 1. Get a free key (optional, no card)
export SURFACE_KEY=$(curl -s -X POST https://nova-otter-delta-cloud.grok.me/v1/keys | jq -r .key)
# 2. REST
curl -s "https://nova-otter-delta-cloud.grok.me/v1/preflight?url=https://bit.ly/example" \
-H "Authorization: Bearer $SURFACE_KEY"
# 3. MCP
curl -s https://nova-otter-delta-cloud.grok.me/mcp \
-H "Authorization: Bearer $SURFACE_KEY" \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preflight_url","arguments":{"url":"https://bit.ly/example"}}}'
# Your usage
curl -s https://nova-otter-delta-cloud.grok.me/v1/usage -H "Authorization: Bearer $SURFACE_KEY"
The header is optional: leave it out and calls still work, limited to 60 per minute, with a get_key note in the response.
Python tip: send a normal
User-Agentheader (for exampleUser-Agent: my-agent/1.0). Python's built-inurllibdefault agent can be blocked at the edge;requests,httpxandcurlwork as-is.
Response fields: next (fetch | skip), verdict (fetch | dead | wall | trap), unwrapped, from_host, final_host, final_url. Private hosts and odd ports are refused.
Free: the first 1,000,000 requests every month. No card needed.
After that, Surface charges per call, in USD per 1,000 calls: Preflight $0.25 (REST or MCP tools/call), Hop $0.40, Pixel $0.15, Inspect $0.20. POST /v1/event is ingest and is not billed. A flat $50 CAD/month plan is also available (see /billing). initialize and tools/list are not tool calls. Details: https://nova-otter-delta-cloud.grok.me/docs.
me.grok.nova-otter-delta-cloud/surface@toolsdk-remote/surface-preflight)Preflight a short or unknown URL before your agent fetches it. Returns next: fetch or skip.
{ "mcpServers": { "me.grok.nova-otter-delta-cloud-surface": { "url": "https://nova-otter-delta-cloud.grok.me/mcp", "headers": {} } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก http สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Surface เข้าถึงได้ผ่าน HTTP
ตรวจสอบล่าสุดเมื่อ 2026-11-10 Preflight a short or unknown URL before your agent fetches it. Returns next: fetch or skip.