CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

secure-mcp-server

Secure an MCP server by applying a policy from the catalog. Handles multiple starting points: from an existing API Manager instance, from an MCP server asset in Exchange, or from scratch by publishing the MCP server first. Use when the user wants to secure an MCP server, add rate limiting, apply OAuth2, enforce IP allowlisting, or protect any MCP server with a policy — regardless of where they are in the setup process.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable and exceptionally well-sequenced content: complete operation specs, error-recovery guidance, and verification checkpoints for every path. The weaknesses are token efficiency (repeated prerequisite blocks, padded tips sections) and the absence of any progressive disclosure — everything lives in one long SKILL.md.

Suggestions

Move the 'Troubleshooting', 'Tips and Best Practices', and 'Related Jobs' sections into a one-level-deep reference file (e.g. references/troubleshooting.md) and keep SKILL.md as the workflow overview with clearly signaled links.

State the organizationId sourcing (listMe → $.user.organization.id) once in Prerequisites and reference it from each step's spec instead of repeating the full 'from' block in all nine steps.

Trim generic filler in 'Next Steps' and 'Tips' (e.g. 'Set up alerts for unusual rejection patterns', 'Check API Manager analytics') down to the concrete, non-obvious guidance such as policy ordering rules.

DimensionReasoningScore

Conciseness

The step specifications are dense and contain non-obvious operational knowledge, but the 'organizationId' input block sourced from 'listMe' is repeated verbatim in all nine steps, and sections like 'Next Steps' and 'Tips and Best Practices' include generic filler such as 'Set up alerts for unusual rejection patterns'. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than score 4, because the repetition and filler are more than minor instances.

3 / 5

Actionability

Every step provides a complete, executable operation spec (api, operationId, exact input values, JSONPath output mappings), plus a concrete request body example and exact error strings with fixes, e.g. '"Field environmentId is required for deployment type HY"'. This is copy-paste-ready guidance covering the common cases, matching the top anchor.

5 / 5

Workflow Clarity

The multi-path flow is explicitly sequenced (mermaid flowchart, 'Execution Paths' step lists), each step has a 'What happens next' transition, key steps include 'Common issues' error-recovery loops (e.g. 409 Conflict → list existing deployments first), and a 'Completion Checklist' verifies the outcome. This matches the top anchor: clear sequence, explicit validation, feedback loops, and a checklist.

5 / 5

Progressive Disclosure

The skill is a ~640-line monolith with no bundle files at all; supplementary content that clearly belongs in one-level-deep references — the 'Troubleshooting' section, 'Tips and Best Practices', and 'Related Jobs' — is inlined alongside the core workflow. Internal headers and diagrams give it real structure, so it fits 'some structure but... content that should be separate is inline' rather than score 2's 'minimal structure'.

3 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, third-person, and MCP-server-scoped, with an explicit 'Use when...' clause covering multiple natural trigger phrases. The only weakness is modest synonym coverage for policy-related terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'applying a policy from the catalog', 'publishing the MCP server first', 'add rate limiting, apply OAuth2, enforce IP allowlisting' — and names the three concrete starting points (API Manager instance, Exchange asset, from scratch), giving comprehensive coverage of the skill's capabilities. This matches the 'multiple specific concrete actions; comprehensive coverage' anchor rather than score 4, which requires 'minor gaps in coverage'.

5 / 5

Completeness

It explicitly answers 'what' ('Secure an MCP server by applying a policy from the catalog' with three named starting paths) and 'when' with a concrete trigger clause ('Use when the user wants to secure an MCP server, add rate limiting, apply OAuth2, enforce IP allowlisting, or protect any MCP server with a policy'). Both are explicit with concrete triggers, matching the top anchor; score 4 would require the 'when' to be less specific.

5 / 5

Trigger Term Quality

Natural phrases users would say are present — 'secure an MCP server', 'add rate limiting', 'apply OAuth2', 'enforce IP allowlisting', plus the synonym pair 'secure'/'protect'. It falls short of the score-5 'comprehensive coverage including synonyms' anchor because common variations like 'throttling', 'blocklist', or 'authentication' are absent.

4 / 5

Distinctiveness Conflict Risk

Every capability statement is scoped to MCP servers ('Secure an MCP server', 'protect any MCP server with a policy'), establishing a clear niche with distinct triggers and minimal conflict risk against generic document or API skills. Voice is third person throughout, so no voice penalty applies.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (646 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

mulesoft/mulesoft-dx

Path

skills/secure-mcp-server/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.