Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add rules/aaydin-tr/swagger-navigator-mcp/project-structuregit clone --depth 1 https://github.com/aaydin-tr/swagger-navigator-mcpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/rules/aaydin-tr/swagger-navigator-mcp/project-structure)<a href="https://agentmods.dev/rules/aaydin-tr/swagger-navigator-mcp/project-structure"><img src="https://agentmods.dev/badge/rules/aaydin-tr/swagger-navigator-mcp/project-structure.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00813 | $0.00813 |
| Opus 5 | $0.00407 | $0.00407 |
| Sonnet 5 | $0.00163 | $0.00163 |
| Haiku 4.5 | $0.00081 | $0.00081 |
Grade A, and why
project-structure scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 97 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Project Structure Guide
Overview
The Swagger Navigator MCP is a Model Context Protocol server for intelligent discovery and search of Swagger/OpenAPI endpoints.
Key Entry Points
- Main server: index.ts - MCP server implementation with tools for API discovery
- Configuration loader: loader.ts - Handles YAML config files with environment variable substitution
- Environment utilities: env-substitution.ts - Secure environment variable substitution
Directory Structure
src/
├── config/ # Configuration management
│ └── loader.ts # YAML config loading with env substitution
├── parsers/ # API specification parsers
│ └── swagger-parser.ts
├── types/ # TypeScript type definitions
│ ├── config.ts # Configuration schemas and validation
│ └── swagger.ts # OpenAPI/Swagger type definitions
├── utils/ # Utility functions
│ └── env-substitution.ts # Environment variable handling
└── index.ts # Main MCP server implementation
tests/ # Mirror src/ structure for tests
├── config/
├── utils/
└── setup.ts # Jest test configuration
Configuration Flow
- loader.ts reads CONFIG_PATH environment variable
- Loads YAML configuration file
- env-substitution.ts processes
${VAR}placeholders - config.ts validates the configuration schema
- Runtime type detection enriches config with source types (http/file)
Security Considerations
- Environment variables store sensitive data (API keys, tokens)
- Configuration files should not contain secrets directly
- Use
${VAR_NAME}syntax for environment variable substitution
Project Structure Guide
Overview
The Swagger Navigator MCP is a Model Context Protocol server for intelligent discovery and search of Swagger/OpenAPI endpoints.
Key Entry Points
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 97 lines · 813 tokens per session scan A 31d6a57c9730
project-structure is a cursor rule published in the GitHub repository aaydin-tr/swagger-navigator-mcp (2 stars, last pushed 2mo ago), licensed MIT. It adds 813 tokens to every session, about $0.0041 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other cursor rules, from other repositories
typescript-coding-rule
It allows a subset of JSDoc tags. Most tags must occupy their own line, with the tag at the beginning of the line.
git-github-workflow
When asked, to create a commit.
architecture
Architecture of openapi-to-cli (ocli).
testing
Test conventions for openapi-to-cli (Jest).
code-style
Code style for openapi-to-cli (TypeScript).
implementation-order
Implementation order for openapi-to-cli (one unit at a time).