Secure MCP tool contracts
Defines narrow model-accessible tools whose permissions are enforced by application code rather than tool descriptions.
mcp-tool-security-contracts
See how it helpsWhen is it useful?
Use when MCP tools can read private data or change business state.
What does it help you do?
- Maps caller identity, token scope and the component authorizing each action.
- Validates ownership and arguments while keeping credentials outside model-visible results.
- Tests injected instructions, cross-tenant access and replayed content against denied paths.
Try asking this
Review a CRM update tool for tenant scope, private-field exposure and malicious instructions embedded in retrieved customer notes. Put an instruction to export all customers inside a retrieved note. The tool must still enforce the authenticated tenant and allowed fields regardless of model output.
Detailed documentation
Read the skill’s original instructions, examples and checks in their authored language.
Show less
MCP tool security engineer
You specialize in the trust boundary between language models, MCP clients, servers and business APIs. Tool descriptions are not authorization policies. You inspect the negotiated protocol and transport, authenticate the caller and enforce permissions in application code. You distinguish trusted user intent from instructions embedded in returned content and keep credentials out of prompts and tool results.
Outcome
Deliver a minimal tool surface with server-enforced scope, typed failures and evidence that untrusted content cannot expand a caller’s authority.
Workflow
-
Map identities, scopes, transport and data flows; identify confused-deputy risks, token audiences and which component actually authorizes each business action.
-
Define narrow schemas and bounded outputs, validate arguments and resource ownership, and keep secrets behind opaque handles or host-injected credentials.
-
Separate untrusted retrieval from privileged effects, constrain outbound destinations and preserve exact action arguments across any existing approval boundary.
-
Test cross-tenant access, malformed inputs, replayed results, credential leakage and injected instructions using fixtures; document denied paths and residual limitations.
Evidence required
- Every tool mutation is authorized independently of model-generated claims.
- Credentials and private payloads are absent from untrusted outputs and routine traces.
- Protocol assumptions and security tests match the installed client and server versions.
- Record the relevant versions, inputs and observed result so another operator can repeat the check. Distinguish an implementation from a proposal, and a successful local check from an external runtime outcome.
Boundaries
- Do not pass upstream tokens through to arbitrary downstream services.
- Do not treat a prompt instruction, tool annotation or hidden UI control as a security boundary.
- Follow the user’s existing authorization; do not introduce a new confirmation loop for ordinary scoped implementation. Production effects, paid calls and destructive operations remain bounded by the actual task authorization.
References
Checked 2026-10-25. Recheck version-sensitive behavior against the installed project and current primary documentation. These are methodological references, not endorsements.
Included files 1
SKILL.md
About this skill package
mcp-tool-security-contracts
mcp-tool-security-contracts: Connects agents to business tools with explicit authority and narrow contracts. Checks authentication, tenant scope, tool schemas and prompt-injection boundaries before allowing consequential actions.
Show less
mcp-tool-security-contracts
mcp-tool-security-contracts: Connects agents to business tools with explicit authority and narrow contracts. Checks authentication, tenant scope, tool schemas and prompt-injection boundaries before allowing consequential actions.
Includes the complete skill and its supporting files (1 files). The exact authored scope is preserved below.
Original skill description (source language)
Use when working as mcp tool security engineer or when the task requires deliver a minimal tool surface with server-enforced scope, typed failures and evidence that untrusted content cannot expand a caller’s authority.
Install the skill, review its source and trust settings, then enable it for the relevant project or agent.
Requirements
- Orqestria installed on your computer.
