nowsecure-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@nowsecure-mcp-server list my applications"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
NowSecure MCP Server ๐๐
Made by Tatavarthi Tarun ยท LinkedIn
A small Model Context Protocol (MCP) server for NowSecure Platform. Built to work
around the broken UI PDF export
(Failed to load report data: Enum "JiraIntegrationCustomFieldType" cannot represent value: "")
by pulling findings through the REST + GraphQL APIs and, when needed, rendering
the remediation PDF locally instead of relying on NowSecure's report service.
Requirements
Node.js >= 18 (the only prerequisite โ
npxfetches the package on demand)A NowSecure Platform API token (PAT) โ each user supplies their own (see Auth)
Related MCP server: mcp-sast-cov
Tools
Tool | What it does |
| Lists your portfolio apps (REST). Find app refs + latest assessment. |
| Returns findings needing remediation as JSON (GraphQL). Ideal for feeding an agent. |
| Renders a clean PDF locally from the findings. Works even when NowSecure's renderer fails. |
| Tries NowSecure's REST PDF endpoint (separate path from the broken UI export). |
Auth (each user uses their own token)
Every user generates their own NowSecure Platform API bearer token (PAT) and puts it in their local MCP config. No token is bundled with this package.
Create one in Platform: Profile icon (top right) > Tokens.
NOWSECURE_TOKEN(required) โ your personal PATNOWSECURE_API_BASE(optional) โ defaults tohttps://api.nowsecure.com
Install
No clone or manual install needed โ npx fetches and runs the latest version.
You just need Node.js >= 18.
MCP client config
All examples run the package via npx (no clone/install needed โ just Node.js
= 18). Replace the token with your own personal PAT.
Claude Code
Use the CLI (recommended โ it validates and writes to the right file):
claude mcp add nowsecure --env NOWSECURE_TOKEN=<your-personal-pat-here> -- npx -y nowsecure-mcp-serverAdd --scope user to make it available across all your projects. Or edit
.mcp.json (project) / ~/.claude.json (user) directly:
{
"mcpServers": {
"nowsecure": {
"command": "npx",
"args": ["-y", "nowsecure-mcp-server"],
"env": { "NOWSECURE_TOKEN": "<your-personal-pat-here>" }
}
}
}Cursor
Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"nowsecure": {
"command": "npx",
"args": ["-y", "nowsecure-mcp-server"],
"env": { "NOWSECURE_TOKEN": "<your-personal-pat-here>" }
}
}
}Google Antigravity
In the agent panel / Settings, open MCP Servers โ Manage / Raw Config to edit
mcp_config.json, then add:
{
"mcpServers": {
"nowsecure": {
"command": "npx",
"args": ["-y", "nowsecure-mcp-server"],
"env": { "NOWSECURE_TOKEN": "<your-personal-pat-here>" }
}
}
}GitHub Copilot (VS Code)
VS Code uses a top-level servers key (not mcpServers). Add to .vscode/mcp.json
in your workspace, or your user mcp.json (Command Palette โ MCP: Open User
Configuration):
{
"servers": {
"nowsecure": {
"type": "stdio",
"command": "npx",
"args": ["-y", "nowsecure-mcp-server"],
"env": { "NOWSECURE_TOKEN": "<your-personal-pat-here>" }
}
}
}Kiro
Add to ~/.kiro/settings/mcp.json (global) or .kiro/settings/mcp.json (workspace):
{
"mcpServers": {
"nowsecure": {
"command": "npx",
"args": ["-y", "nowsecure-mcp-server"],
"env": { "NOWSECURE_TOKEN": "<your-personal-pat-here>" },
"disabled": false,
"autoApprove": ["list_applications", "get_remediation_findings"]
}
}
}If published to a private/scoped registry, use the scoped name instead, e.g.
"args": ["-y", "@your-scope/nowsecure-mcp-server"].
Example usage
First list your apps with list_applications to find an app ref, then ask your
agent (placeholders shown โ substitute your own refs):
Generate a remediation PDF for app
<app-ref-uuid>to ./remediation.pdf
If you omit the assessment ref, the latest assessment for that app is used.
Author
Tatavarthi Tarun ๐๐ linkedin.com/in/tatav
If this saved you from NowSecure's broken PDF export, a connect on LinkedIn is appreciated!
Available Tools
5 toolsdownload_assessment_pdfA
Attempt to download NowSecure's own PDF via the REST report endpoint (/report/assessment/ref/{ref}.pdf). This is a different code path than the broken UI export and may succeed. Falls back gracefully with an error if NowSecure's renderer also fails.
Inputs: assessmentRef (required), outputPath (required), onlyRemediation.
generate_remediation_pdfA
Generate a clean remediation PDF locally from NowSecure findings (rendered by this server, NOT NowSecure's broken report service). Includes only open findings requiring remediation (default severities: blocker, critical, high, medium). Guaranteed to work even when the UI/REST PDF export fails. The server auto-names the file as [App_Name]NowSecure_report[yyyy-MM-dd_HHmmss].pdf when given outputDir + appName.
Inputs: appRef (required), assessmentRef, outputDir, appName, +2 more.
get_remediation_findingsA
Pull findings that need remediation for an assessment, as structured JSON. Bypasses the broken NowSecure UI PDF renderer by querying GraphQL directly. Returns only open findings that require remediation (status detected/fail/open), filtered by severity (default: blocker, critical, high, medium). Passed and dismissed findings are excluded.
Inputs: appRef (required), assessmentRef, impactTypes.
list_applicationsA
List applications in your NowSecure portfolio (REST /v2/portfolio/applications). Use to discover app refs and the latest assessment per app.
Inputs: pageSize, orderBy.
run_graphqlA
Run an arbitrary GraphQL query/mutation against the NowSecure Platform API. Escape hatch for schema introspection and custom queries.
Inputs: query (required), variables.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: downloading PDF, generating local PDF, getting structured findings, listing apps, and running arbitrary GraphQL queries. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (download_assessment_pdf, generate_remediation_pdf, get_remediation_findings, list_applications, run_graphql). The naming convention is uniform and predictable.
With 5 tools, the server is well-scoped for a remediation-focused workflow. It provides enough functionality without unnecessary bloat, and each tool earns its place.
The tool set covers the core remediation workflow (list apps, get findings, generate PDF) and includes a GraphQL escape hatch for custom operations. Minor gaps like direct update/delete actions are missing but can be addressed via run_graphql.
Maintenance
Related MCP Connectors
Security scanning for code, containers and IaC: request scans, read findings, report fixes.
Programmatic control of the Hiro security platform: scans, tasks, plans, and approvals.
Scan Android and iOS apps for security issues: findings, MASVS mapping and pentest reports.
Generate SBOMs, scan vulnerabilities, and analyze dependencies from local projects or Git repos.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables querying projects, fetching findings, triggering analysis, uploading CycloneDX BOMs, and checking async token status for OWASP Dependency-Track.25 npm1MIT
- FlicenseNot gradedqualityCmaintenanceEnables querying SAST code quality and security data from SonarQube and Coverity Connect via MCP, including quality gates, issues, projects, streams, and defects.177 npm1-
- AlicenseAqualityBmaintenanceEnables LLM agents to browse and triage vulnerability observations, manage products, branches and rules, import scan reports and SBOMs, run scans and background jobs, and generate VEX documents via SecObserve's REST API.1878 PyPI2MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to scan codebases, persist and prioritize security findings against SLAs, retrieve CVE details, propose fixes, and create tickets through its tools. It also supports agent-assisted remediation drafting while enforcing human approval and preventing auto-merge.1MIT