Rules index¶
Who this page is for: anyone looking up what a specific rule does.
mcpolish ships 23 first-party rules. Each rule has a stable rule ID like MP010 and a human name like generic-tool-name. The ID never changes. The name may be tweaked but the slug stays.
Rules are grouped into five categories: schema, naming, description, consistency, security. Categories carry weight in the score.
Schema (5 rules)¶
The tool is missing required pieces of metadata.
| ID | Name | Severity | Auto-fix |
|---|---|---|---|
| MP001 | require-tool-description | error | safe |
| MP002 | require-param-description | warning | - |
| MP003 | require-return-schema | note | - |
| MP004 | require-required-array | warning | - |
| MP005 | valid-json-schema | error | - |
Naming (5 rules)¶
Tool names confuse the agent.
| ID | Name | Severity | Auto-fix |
|---|---|---|---|
| MP010 | generic-tool-name | warning | - |
| MP011 | redundant-prefix | error | unsafe |
| MP012 | inconsistent-verb-pattern | warning | - |
| MP013 | name-collision-cross-server | warning | - |
| MP014 | snake-vs-camel | note | - |
Description (7 rules)¶
The English text agents read has problems.
| ID | Name | Severity | Auto-fix | LLM |
|---|---|---|---|---|
| MP020 | description-too-short | warning | - | - |
| MP021 | description-too-long | note | - | - |
| MP022 | missing-example | note | - | - |
| MP023 | no-trigger-condition | note | - | - |
| MP024 | jargon-density | note | - | - |
| MP025 | useless-qualifier | note | - | - |
| MP026 | ambiguous-description | warning | - | yes |
Consistency (4 rules)¶
Pieces of metadata disagree with each other.
| ID | Name | Severity | Auto-fix | LLM |
|---|---|---|---|---|
| MP030 | param-type-mismatch | error | - | - |
| MP031 | param-meaning-mismatch | warning | - | yes |
| MP032 | undocumented-side-effect | error | - | yes |
| MP033 | duplicate-tool-description | error | - | - |
Security (2 rules)¶
The description contains a known attack pattern.
| ID | Name | Severity | Auto-fix |
|---|---|---|---|
| MP040 | hidden-prompt-injection | error | - |
| MP041 | instruction-in-description | error | - |