Skip to main content
Glama
sigsci-mcp-server

sigsci-mcp-server

by yuki777

sigsci-mcp-server

MCP server implementation for the Signal Sciences (Fastly NGWAF) API.

日本語版はこちら → README.ja.md

Implements the Code execution with MCP approach to minimize context consumption from tool definitions.

Features

  • Progressive Disclosure: Dynamically discover and load only the tools you need

  • 40+ API tools: Read-only corp/site APIs supported

  • Type-safe: Fully typed with TypeScript

  • MCP compliant: Built on the Model Context Protocol SDK

Related MCP server: Shannon Lite MCP

Usage

Configure for Cursor / Claude Desktop

  • Add to ~/.cursor/mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "sigsci-mcp-server": {
      "command": "npx",
      "args": ["-y", "https://github.com/yuki777/sigsci-mcp-server"],
      "env": {
        "SIGSCI_EMAIL": "your-email@example.com",
        "SIGSCI_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Corp tools

Tool

Description

sigsci_list_corps

List corporations

sigsci_get_corp

Get corporation details

sigsci_get_corp_report

Get attack report

sigsci_list_corp_activity

List corp activity events

sigsci_list_corp_users

List corp users

sigsci_get_corp_user

Get corp user details

sigsci_list_corp_rules

List corp rules

sigsci_get_corp_rule

Get corp rule details

sigsci_list_corp_tags

List corp signal tags

sigsci_get_corp_tag

Get corp signal tag details

sigsci_list_corp_lists

List corp lists

sigsci_get_corp_list

Get corp list details

sigsci_list_corp_integrations

List corp integrations

sigsci_get_corp_integration

Get corp integration details

sigsci_list_cloudwaf_instances

List CloudWAF instances

sigsci_list_cloudwaf_certs

List CloudWAF certificates

Site tools

Tool

Description

sigsci_list_sites

List sites

sigsci_get_site

Get site details

sigsci_list_site_activity

List site activity events

sigsci_list_site_members

List site members

sigsci_get_site_member

Get site member details

sigsci_list_site_rules

List site rules

sigsci_get_site_rule

Get site rule details

sigsci_list_templates

List rule templates

sigsci_get_template

Get rule template details

sigsci_list_configured_templates

List configured templates

sigsci_get_configured_template

Get configured template details

sigsci_list_site_tags

List site signal tags

sigsci_get_site_tag

Get site signal tag details

sigsci_list_site_lists

List site lists

sigsci_get_site_list

Get site list details

sigsci_list_alerts

List alerts

sigsci_get_alert

Get alert details

sigsci_search_requests

Search requests

sigsci_get_request

Get request details

sigsci_get_request_feed

Get request feed

sigsci_list_events

List events

sigsci_get_event

Get event details

sigsci_list_suspicious_ips

List suspicious IPs

sigsci_list_rate_limited_ips

List rate-limited IPs

sigsci_get_whitelist

Get whitelist

sigsci_get_blacklist

Get blacklist

sigsci_list_agents

List agents

sigsci_get_agent

Get agent details

sigsci_list_top_attacks

List top attacks

sigsci_get_timeseries

Get timeseries data

Meta tools (for Progressive Disclosure)

Tool

Description

sigsci_search_tools

Search tools by keyword

sigsci_list_tool_categories

List tools by category

Using Progressive Disclosure

This MCP server implements Anthropic’s recommended Code execution with MCP approach.

Problems with traditional MCP

  1. Tool definitions consume context: Preloading all definitions costs many tokens

  2. Redundant intermediate results: API responses can flood context as-is

How this server addresses them

  1. On-demand tool discovery: Use sigsci_search_tools and sigsci_list_tool_categories to find only what you need

  2. Control detail level: detailLevel lets you choose name-only/with descriptions/full definitions

  3. Tool definitions as resources: Access tool definition files as MCP resources

Example

// 1. Check categories first
await sigsci_list_tool_categories({ detailLevel: "name" });

// 2. Search for the needed tools
await sigsci_search_tools({ keyword: "request", detailLevel: "description" });

// 3. Call only the needed tools
await sigsci_search_requests({
  corpName: "my-corp",
  siteName: "my-site",
  q: "tag:XSS",
});

Development

# Dev mode (watch)
npm run dev

# Build
npm run build

# Lint
npm run lint

# Test
npm test

License

MIT

References

Available Tools

48 tools
sigsci_get_agentC

Get details of a specific agent

Inputs: corpName (required), siteName (required), agentName (required).

sigsci_get_alertC

Get details of a specific alert

Inputs: corpName (required), siteName (required), alertId (required).

sigsci_get_blacklistC

Get blacklist for a site

Inputs: corpName (required), siteName (required).

sigsci_get_configured_templateB

Get details of a specific configured template

Inputs: corpName (required), siteName (required), templateId (required).

sigsci_get_corpB

Get details of a specific corporation by name

Inputs: corpName (required).

sigsci_get_corp_integrationB

Get details of a specific integration in a corporation

Inputs: corpName (required), integrationId (required).

sigsci_get_corp_listB

Get details of a specific list in a corporation

Inputs: corpName (required), listId (required).

sigsci_get_corp_reportC

Get attack overview report for a corporation

Inputs: corpName (required), from, until.

sigsci_get_corp_ruleB

Get details of a specific rule in a corporation

Inputs: corpName (required), ruleId (required).

sigsci_get_corp_tagB

Get details of a specific signal tag in a corporation

Inputs: corpName (required), tagName (required).

sigsci_get_corp_userB

Get details of a specific user in a corporation

Inputs: corpName (required), email (required).

sigsci_get_eventC

Get details of a specific event

Inputs: corpName (required), siteName (required), eventId (required).

sigsci_get_requestA

Get details of a specific request by ID

Inputs: corpName (required), siteName (required), requestId (required).

sigsci_get_request_feedC

Get request feed for a site within a time range

Inputs: corpName (required), siteName (required), from (required), until (required), +1 more.

sigsci_get_siteA

Get details of a specific site

Inputs: corpName (required), siteName (required).

sigsci_get_site_listB

Get details of a specific list in a site

Inputs: corpName (required), siteName (required), listId (required).

sigsci_get_site_memberA

Get details of a specific site member

Inputs: corpName (required), siteName (required), email (required).

sigsci_get_site_ruleA

Get details of a specific rule in a site

Inputs: corpName (required), siteName (required), ruleId (required).

sigsci_get_site_tagA

Get details of a specific signal tag in a site

Inputs: corpName (required), siteName (required), tagName (required).

sigsci_get_templateC

Get details of a specific rule template

Inputs: corpName (required), siteName (required), templateId (required).

sigsci_get_timeseriesB

Get timeseries request data for a site

Inputs: corpName (required), siteName (required), from, until, +2 more.

sigsci_get_whitelistB

Get whitelist for a site

Inputs: corpName (required), siteName (required).

sigsci_list_agentsB

List all agents for a site

Inputs: corpName (required), siteName (required).

sigsci_list_alertsC

List all alerts for a site

Inputs: corpName (required), siteName (required).

sigsci_list_cloudwaf_certsA

List all CloudWAF certificates in a corporation

Inputs: corpName (required).

sigsci_list_cloudwaf_instancesC

List all CloudWAF instances in a corporation

Inputs: corpName (required).

sigsci_list_configured_templatesB

List configured templated rules for a site

Inputs: corpName (required), siteName (required).

sigsci_list_corp_activityB

List activity events for a corporation

Inputs: corpName (required), limit, page.

sigsci_list_corp_integrationsB

List all integrations in a corporation

Inputs: corpName (required).

sigsci_list_corp_listsB

List all lists in a corporation

Inputs: corpName (required).

sigsci_list_corp_rulesA

List all rules in a corporation

Inputs: corpName (required), type, page, limit.

sigsci_list_corpsA

List all corporations accessible to the authenticated user

Inputs: no named parameters.

sigsci_list_corp_tagsA

List all signal tags in a corporation

Inputs: corpName (required).

sigsci_list_corp_usersB

List all users in a corporation

Inputs: corpName (required), expand.

sigsci_list_eventsC

List events for a site

Inputs: corpName (required), siteName (required), from, until, +5 more.

sigsci_list_rate_limited_ipsB

List rate-limited IPs for a site

Inputs: corpName (required), siteName (required), limit.

sigsci_list_site_activityB

List activity events for a site

Inputs: corpName (required), siteName (required), from, until, +5 more.

sigsci_list_site_listsC

List all lists in a site

Inputs: corpName (required), siteName (required).

sigsci_list_site_membersB

List all members of a site

Inputs: corpName (required), siteName (required).

sigsci_list_site_rulesC

List all rules in a site

Inputs: corpName (required), siteName (required), type, page, +1 more.

sigsci_list_sitesC

List all sites in a corporation

Inputs: corpName (required), name, page, limit, +1 more.

sigsci_list_site_tagsB

List all signal tags in a site

Inputs: corpName (required), siteName (required).

sigsci_list_suspicious_ipsB

List suspicious IPs for a site

Inputs: corpName (required), siteName (required), limit.

sigsci_list_templatesB

List available rule templates for a site

Inputs: corpName (required), siteName (required).

sigsci_list_tool_categoriesA

List available tool categories and their tools

Inputs: category, detailLevel.

sigsci_list_top_attacksC

List top attacks for a site

Inputs: corpName (required), siteName (required), from, until, +2 more.

sigsci_search_requestsC

Search requests for a site with optional query filters

Inputs: corpName (required), siteName (required), q, page, +1 more.

sigsci_search_toolsA

Search for available tools by keyword

Inputs: keyword (required), detailLevel.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 48 tools

    Disambiguation5/5

    Each tool name clearly specifies the resource and action (e.g., sigsci_get_agent vs sigsci_list_agents). Even with many tools, the hierarchical naming (corp vs site) ensures no ambiguity between similar resources.

    Naming Consistency5/5

    All tools follow a consistent pattern: 'sigsci_verb_noun'. Verbs are limited to 'get_', 'list_', and 'search_', which clearly indicate the operation. This makes the set predictable and easy to navigate.

    Tool Count2/5

    With 48 tools, the server exceeds the recommended range for well-scoped tools (3-15). While the tools cover many resources, the high count likely makes it harder for an agent to select the right one, justifying a low score.

    Completeness2/5

    The tool set is entirely read-only (get, list, search) with no create, update, or delete operations. For a server named sigsci, likely managing a security platform, the lack of mutation capabilities is a significant gap that restricts agent workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server for full Qualys portal management — expose VMDR, Policy Compliance, WAS, Cloud Agent, Container Security, TotalCloud, Patch Management, CSAM/GAV, EASM and administration to any MCP‑capable client.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Tenable.io/One Vulnerability Management that provides read-only tools for querying scans, assets, plugins, and vulnerabilities, plus specialized reporting tools for VPR re-prioritization, CISA KEV/EPSS exposure, and scan delta comparisons.
      11
      3
      MIT