Scry

Official12 toolsLive

by TunnelMind · JavaScript

Free IPv4 lookups against a distributed attacker-observation corpus.

MCP Server: ai.tunnelmind/scry

The ai.tunnelmind/scry MCP server provides free IPv4 lookups against a distributed attacker-observation corpus. It wraps public scry-api endpoints as agent-callable tools, hosted at mcp.tunnelmind.ai, using MCP spec version 2025-03-26 with streamable HTTP transport.

🛠️ Key Features

Free IPv4 lookups for attacker-observation corpus (via tool scry_check)
Wraps scry-api public endpoints
Hosted at mcp.tunnelmind.ai
MCP spec version 2025-03-26
Streamable HTTP transport
Topics: agentic-ai, cloudflare-workers, mcp, mcp-server, security, threat-intelligence

🚀 Use Cases

Check an IP via GET /v1/check/{ip}
Developer integration for threat-intelligence lookups using MCP

⚡ Developer Benefits

Single available tool surface (toolCount: 12 listed; tools described include scry_check)
Agent-callable wrapper around scry-api endpoints
Designed for streamable HTTP interaction

⚠️ Limitations

Only scry_check (v0.1, Free tier) is explicitly available in the excerpt
Future tools are deferred to a “defender tier” requiring ATAP attestation (scry_watch, scry_actor)

Topics

agentic-aicloudflare-workersmcpmcp-serversecuritythreat-intelligence

Captured live from the server via tools/list.

scry_stats

Returns aggregate Scry corpus telemetry: total observation count, distinct source IPs, first/last observation timestamps, last-24h activity, and per-protocol breakdowns. Useful as a liveness/density check before issuing per-IP queries — lets an agent decide whether the corpus has enough data to be authoritative. Use this tool when: - An agent is planning a multi-step investigation and wants to know if Scry has corpus density worth querying. - You want a 'corpus health' signal in a dashboard or report. Do NOT use this tool when: - You want details about a specific IP — use `scry_check`. - You want sensor fleet size or node identities — never exposed at any tier. Inputs: none. Returns: total_observations, distinct_source_ips, first_seen_ms, last_seen_ms, observations_last_24h, distinct_source_ips_last_24h, by_protocol, as_of_ms. Cost: free, anonymous, rate-limited. Latency: <100ms typical.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

scry_check

Returns Scry's corpus knowledge for a single IPv4 address: when it was first/last observed, observation count, protocols and ports targeted, ASN, country, category (actor/scanner/not_observed), and confidence_bucket (low/medium/high). Use when an agent needs IP triage, hostility assessment, or risk signaling. Do NOT use for raw payloads (never exposed) or IPv6 (corpus is v4-only at v0.1).

Parameters1

string

required

IPv4 address (e.g. '8.8.8.8')

Raw schema

{
  "type": "object",
  "properties": {
    "ip": {
      "type": "string",
      "description": "IPv4 address (e.g. '8.8.8.8')"
    }
  },
  "required": [
    "ip"
  ],
  "additionalProperties": false
}

scry_check_bulk

Look up many IPv4 addresses in one request. Up to 100 IPs per call. Same per-IP shape as scry_check, keyed by IP.

Parameters1

ips

array

required

Raw schema

{
  "type": "object",
  "properties": {
    "ips": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 100
    }
  },
  "required": [
    "ips"
  ],
  "additionalProperties": false
}

scry_top

Top-N source dimensions over a time window. Useful for situational awareness — 'where is the noise coming from right now?'

Parameters4

dimension	string	optional
since_ms	integer	optional
limit	integer	optional
include_noise	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "dimension": {
      "type": "string",
      "enum": [
        "asn",
        "country",
        "protocol",
        "port"
      ]
    },
    "since_ms": {
      "type": "integer"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "include_noise": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

scry_timeseries

Bucketed observation counts over time. Detect bursts, plot trends, sanity-check whether attacker activity is rising or falling.

Parameters3

bucket	string	optional
since_ms	integer	optional
until_ms	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "bucket": {
      "type": "string",
      "enum": [
        "minute",
        "hour",
        "day"
      ]
    },
    "since_ms": {
      "type": "integer"
    },
    "until_ms": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}

scry_asn

Roll-up of corpus activity for a single ASN — observation count, distinct source IPs, actor count, scanner count, high-confidence actor count, and per-protocol breakdown.

Parameters2

asn	string	required
since_ms	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "asn": {
      "type": "string"
    },
    "since_ms": {
      "type": "integer"
    }
  },
  "required": [
    "asn"
  ],
  "additionalProperties": false
}

scry_country

Roll-up of corpus activity by ISO country code. Same shape as scry_asn.

Parameters2

country	string	required
since_ms	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "since_ms": {
      "type": "integer"
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false
}

scry_tools

List detected attack tools — (protocol, payload, path) tuples sent by 3+ distinct source IPs. Aggregate metadata only; never lists member actors.

Parameters3

protocol	string	optional
since_ms	integer	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "protocol": {
      "type": "string"
    },
    "since_ms": {
      "type": "integer"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false
}

scry_tool

Single tool detail by 16-char hex id from scry_tools.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{16}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

scry_campaigns

Active threat campaigns — coordinated attacker activity that exceeds the noise floor. ≥5 distinct actors, ≥3 ASNs, ≤5 destination ports, ≥1h history.

Parameters2

include_inactive	boolean	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "include_inactive": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false
}

scry_campaign

Single campaign detail by id (format: c[0-9a-f]{15}).

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^c[0-9a-f]{15}$"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

scry_recent

Recent observations feed — aggregated by source IP within a time window. Cursor-paginated via since_ms.

Parameters5

since_ms	integer	optional
limit	integer	optional
protocol	string	optional
country	string	optional
include_noise	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "since_ms": {
      "type": "integer"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "protocol": {
      "type": "string"
    },
    "country": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$"
    },
    "include_noise": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

README.md2 KBView on GitHub

scry-mcp

MCP (Model Context Protocol) server for the Scry corpus. Wraps the scry-api public endpoints as agent-callable tools.

Hosted at mcp.tunnelmind.ai. MCP spec version 2025-03-26. Streamable HTTP transport.

Tools (v0.1)

Tool	Wraps	Tier
`scry_check`	`GET /v1/check/{ip}`	Free

Future tools (deferred to defender tier; need ATAP attestation):

scry_watch — subscribe to state changes for an IP/domain
scry_actor — full actor profile
scry_campaign — campaign detail

Wire protocol

code

POST https://mcp.tunnelmind.ai/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"initialize"}

Methods:

initialize — handshake, returns { protocolVersion, capabilities, serverInfo }
notifications/initialized — client → server notification (returns 204)
tools/list — returns { tools: [...] }
tools/call — { name, arguments } → { content: [{ type: "text", text }] }
ping — returns {}

Discovery:

code

GET https://mcp.tunnelmind.ai/
→ { service, version, protocol, transport, endpoint, tools }

Layout

code

src/
  worker.js   transport (JSON-RPC 2.0 over POST /mcp)
  tools.js    tool definitions + handlers
test/
  tools.test.js   unit tests for tool registry

Setup

bash

npm test
npx wrangler deploy

No bindings, no secrets — this Worker is a thin proxy with no state.

Install

Tools (12)

scry_statsscry_checkscry_check_bulkscry_topscry_timeseriesscry_asnscry_countryscry_tools

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.tunnelmind.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "scry": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tunnelmind.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: ai.tunnelmind/scry

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

scry_stats

scry_check

scry_check_bulk

scry_top

scry_timeseries

scry_asn

scry_country

scry_tools

scry_tool

scry_campaigns

scry_campaign

scry_recent

scry-mcp

Tools (v0.1)

Wire protocol

Layout

Setup

Install

Remote endpoint

Related servers