push_files
Push files to repository
Part of the GitHub MCP server. Enforce policies on this tool with Intercept, the open-source MCP proxy.
WHEN AI AGENTS USE THIS TOOL
AI agents use push_files to create or modify resources in GitHub. Write operations carry medium risk because an autonomous agent could trigger bulk unintended modifications. Rate limits prevent a single agent session from making hundreds of changes in rapid succession. Argument validation ensures the agent passes expected values.
WHY ENFORCE A POLICY ON PUSH_FILES
Without a policy, an AI agent could call push_files repeatedly, creating or modifying resources faster than any human could review. Intercept's rate limiting ensures write operations happen at a controlled pace, and argument validation catches malformed or unexpected inputs before they reach GitHub.
RECOMMENDED POLICY
Write tools can modify data. A rate limit prevents runaway bulk operations from AI agents.
tools:
push_files:
rules:
- action: allow
rate_limit:
max: 30
window: 60See the full GitHub policy for all 83 tools.
DETAILS
MORE GITHUB TOOLS
add_comment_to_pending_review Write add_issue_comment Write add_reply_to_pull_request_comment Write create_branch Write create_gist Write create_or_update_file Write create_pull_request Write create_pull_request_with_copilot Write SIMILAR WRITE TOOLS ON OTHER SERVERS
RELATED READING
FREQUENTLY ASKED QUESTIONS
What does the push_files tool do?
Push files to repository. It is categorised as a Write tool in the GitHub MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
How do I enforce a policy on push_files?
Add a rule in your Intercept YAML policy under the tools section for push_files. You can allow, deny, rate-limit, or validate arguments. Then run Intercept as a proxy in front of the GitHub MCP server.
What risk level is push_files?
push_files is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Can I rate-limit push_files?
Yes. Add a rate_limit block to the push_files rule in your Intercept policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
How do I block push_files completely?
Set action: deny in the Intercept policy for push_files. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
What MCP server provides push_files?
push_files is provided by the GitHub MCP server (github/github-mcp-server). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.
ENFORCE POLICIES ON GITHUB
Open source. One binary. Zero dependencies.