project-structure

A description of the repository's folder and file layout, including source code, tests or workflows, editor settings, and package-related directories.

In plain words
What is it for?
Use it when navigating the repository, finding GitHub Actions, locating Model Context Protocol code, or deciding where new files belong.
Why use it?
It helps developers locate files and understand how the project is organized before making changes.

Cursor rule for Cursor

Install

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.

agentmods
npx agentmods add rules/commercetools/mcp-essentials/project-structure
Clone the repo
git clone --depth 1 https://github.com/commercetools/mcp-essentials

Made for: Cursor.

Per session 2 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,555 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5 $0.00002 $0.01555
Opus 5 $0.00001 $0.00777
Sonnet 5 $0.00000 $0.00311
Haiku 4.5 $0.00000 $0.00155

Measured 2d ago against content hash 5f8f2bfc69dc, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

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 2d 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.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

.cursor/rules/project-structure.mdc · 96 lines

How it starts

The opening of the file, as written. The whole thing — 96 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Repository Structure

This document provides an overview of the directory structure for this repository.

/
├── .github/                     # GitHub specific configurations
│   ├── ISSUE_TEMPLATE/          # Templates for creating GitHub issues
│   │   ├── bug_report.yml       # Template for bug reports
│   │   ├── config.yml           # Configuration for issue templates
│   │   └── feature_request.yml  # Template for feature requests
│   └── workflows/               # GitHub Actions workflows
│       ├── main.yml             # Main CI/CD workflow (e.g., testing, linting)
│       └── release.yml          # Workflow for creating releases
├── .git/                        # Git version control data (usually hidden)
├── .vscode/                     # VS Code editor configurations
├── modelcontextprotocol/        # Core package for the Model Context Protocol implementation
│   ├── node_modules/            # Project dependencies (managed by npm/pnpm/yarn)
│   ├── scripts/                 # Utility scripts for the package
│   │   └── publish              # Script for publishing the package
│   ├── src/                     # Source code for the modelcontextprotocol package
│   │   ├── index.ts             # Main entry point for the package
│   │   └── test/                # Unit tests for the package
│   │       └── index.test.ts    # Tests for the main entry point
│   ├── .gitignore               # Specifies intentionally untracked files that Git should ignore
│   ├── .prettierrc              # Configuration file for the Prettier code formatter
│   ├── eslint.config.mjs        # Configuration file for the ESLint linter
│   ├── jest.config.ts           # Configuration file for the Jest testing framework
│   ├── package-lock.json        # Records exact versions of dependencies (npm)
│   ├── package.json             # Defines package metadata, dependencies, and scripts
│   ├── pnpm-lock.yaml           # Records exact versions of dependencies (pnpm)
│   ├── README.md                # README specific to the modelcontextprotocol package
│   └── tsconfig.json            # TypeScript compiler options for this package
├── typescript/                  # TypeScript specific implementations or toolkits using the protocol
│   ├── examples/                # Example usage of the TypeScript toolkit
│   │   ├── ai-sdk/              # Example using the AI SDK integration
│   │   │   ├── .env.template    # Template for environment variables
│   │   │   ├── index.ts         # Example script demonstrating usage
│   │   │   ├── package.json     # Dependencies for the example
│   │   │   ├── README.md        # README for the ai-sdk example
│   │   │   └── tsconfig.json    # TypeScript configuration for the example
│   │   └── langchain/           # Example using the Langchain integration
│   │       ├── .env.template    # Template for environment variables
│   │       ├── index.ts         # Example script demonstrating usage
│   │       ├── package.json     # Dependencies for the example
│   │       ├── README.md        # README for the langchain example
│   │       └── tsconfig.json    # TypeScript configuration for the example
│   ├── node_modules/            # Project dependencies (managed by npm/pnpm/yarn)
│   ├── scripts/                 # Utility scripts for the TypeScript packages/workspace
│   │   └── publish              # Script for publishing the package(s)
│   ├── src/                     # Source code for the TypeScript toolkit/packages
│   │   ├── ai-sdk/              # Integration layer for the AI SDK
│   │   │   ├── index.ts         # Entry point for the AI SDK integration
│   │   │   └── toolkit.ts       # Toolkit implementation specific to AI SDK
│   │   ├── langchain/           # Integration layer for Langchain
│   │   │   ├── index.ts         # Entry point for the Langchain integration
│   │   │   └── toolkit.ts       # Toolkit implementation specific to Langchain
│   │   ├── modelcontextprotocol/# Re-export or specific implementation related to the core protocol
│   │   │   ├── index.ts         # Entry point
│   │   │   └── toolkit.ts       # Toolkit implementation
│   │   ├── shared/              # Shared utilities and components for TypeScript packages
│   │   │   ├── api.ts           # API definitions or clients
│   │   │   ├── configuration.ts # Configuration handling logic
│   │   │   ├── functions.ts     # Utility functions
│   │   │   ├── parameters.ts    # Parameter definitions or handling
│   │   │   ├── prompts.ts       # Prompt templates or management
│   │   │   └── tools.ts         # Tool definitions or handling
│   │   └── test/                # Tests for the TypeScript code
│   │       └── shared/          # Tests for the shared components
│   │           ├── configuration.test.ts # Tests for configuration logic
│   │           └── functions.test.ts     # Tests for utility functions
│   ├── .gitignore               # Specifies intentionally untracked files that Git should ignore
│   ├── .prettierrc              # Configuration file for the Prettier code formatter
│   ├── .vscode/                 # VS Code editor configurations specific to the typescript directory
│   ├── eslint.config.mjs        # Configuration file for the ESLint linter
│   ├── jest.config.ts           # Configuration file for the Jest testing framework
│   ├── package-lock.json        # Records exact versions of dependencies (npm)
│   ├── package.json             # Defines package metadata, dependencies, and scripts (likely for the workspace)
│   ├── pnpm-lock.yaml           # Records exact versions of dependencies (pnpm)
│   ├── pnpm-workspace.yaml      # Defines the pnpm workspace configuration
│   ├── README.md                # README specific to the TypeScript part of the repository
│   ├── template.env             # Template for environment variables
│   ├── tsconfig.json            # Base TypeScript compiler options for the workspace
│   └── tsup.config.ts           # Configuration for the tsup bundler
├── .gitignore                   # Specifies intentionally untracked files that Git should ignore at the root level
├── LICENSE                      # Repository license information
├── package-lock.json            # Records exact versions of root-level dependencies (if any, potentially for dev tools)
├── package.json                 # Root package.json, might define workspace root or global dev dependencies
├── README.md                    # Main README file for the repository
└── SECURITY.md                  # Security policy and reporting instructions

Read the full file on GitHub · 96 lines

Changes

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.

  1. 2d ago First seen · 96 lines · 2 tokens per session scan A 5f8f2bfc69dc

Subscribe to this mod's changes

project-structure is a cursor rule published in the GitHub repository commercetools/mcp-essentials (13 stars, last pushed 15d ago), licensed MIT. It adds 2 tokens to every session and 1,555 once invoked, about $0.0000 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-30.