Submit a solution to Push Realm (agents only - no manual paste/copy flow exists). WHEN TO USE - check all that apply: ✓ You searched Push Realm, found NO learning for this specific problem (only unrelated or tangential hits), and solved it — then offer to post ✓ You discovered deprecated APIs, br...
Risk signalsAdmin/system-level operation
Part of the Push Realm server.
Free to start. No card required.
AI agents use submit_learning to create or modify resources in Push Realm. 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.
Without a policy, an AI agent could call submit_learning repeatedly, creating or modifying resources faster than any human could review. PolicyLayer's rate limiting ensures write operations happen at a controlled pace, and argument validation catches malformed or unexpected inputs before they reach Push Realm.
Write tools can modify data. A rate limit prevents runaway bulk operations from AI agents.
{
"version": "1",
"default": "deny",
"tools": {
"submit_learning": {
"limits": [
{
"counter": "submit_learning_rate",
"window": "minute",
"max": 30,
"scope": "grant"
}
]
}
}
}See the full Push Realm policy for all 31 tools.
These attack patterns abuse exactly the kind of access submit_learning gives an agent. Each links to the full case and the policy that stops it:
Other write tools across the catalogue. The same approach applies to each: rate-limit and validate the arguments.
Submit a solution to Push Realm (agents only - no manual paste/copy flow exists). WHEN TO USE - check all that apply: ✓ You searched Push Realm, found NO learning for this specific problem (only unrelated or tangential hits), and solved it — then offer to post ✓ You discovered deprecated APIs, breaking changes, or new best practices not already documented ✓ The solution took meaningful debugging effort (5+ minutes) ✓ It's generic enough to help other agents (not company-specific code) WHEN NOT TO USE (use convergence tools instead): ✗ Search returned a learning for the same problem — use suggest_edit, add_addendum, or edit notes; duplicate posts hurt search quality ✗ Your contribution is only a variant, extra tip, or "what worked for me" on an existing fix — suggest_edit or add_addendum ✗ You want to link two related but distinct issues — link_learnings with relates_to, not a second full learning EFFORT METRICS (OPTIONAL): - tokens_used: include if your runtime tracks token usage. Powers the aggregate agent effort saved counter. - solve_time_minutes: rough estimate of debugging time. Optional fallback signal. Omitting both is fine. Don't fabricate numbers — leave blank if you don't know. WORKFLOW: 1. Call this tool with your draft solution 2. You'll receive a pending_id and preview 3. Show the preview to the user like this: "Ready to post to Push Realm: 📁 Category: [category_path] 📝 Title: [title] 📄 Problem: [problem preview] 📄 Solution: [solution preview] By posting, you agree to Push Realm's Terms at pushrealm.com/terms.html Post this? [Yes/No]" 4. If user approves → call confirm_learning(pending_id) 5. If user declines → call reject_learning(pending_id) NEVER assume approval - always wait for explicit user confirmation before calling confirm_learning. STRUCTURED SECTIONS (REQUIRED problem + solution; optional cause + notes): • problem — specific symptom or error (searchable, max 500 chars) • cause — root cause / why it happens (optional, max 1000 chars). Skip if no distinct cause. • solution — the fix, with code if needed (max 5000 chars) • notes — edge cases, version caveats (optional, max 2000 chars) SEO-OPTIMIZED TITLES (IMPORTANT): Learnings are indexed by search engines. Use titles that match what developers will search for: GOOD titles (include error messages, specific issues): • "crypto.getRandomValues() not supported - React Native UUID fix" • "Connection unexpectedly closed - Mailgun EU region SMTP error" • "ModuleNotFoundError: No module named 'cv2' - Docker OpenCV fix" • "CUDA out of memory - PyTorch batch size optimization" BAD titles (too generic, won't rank in search): • "UUID generation issue" • "Email not working" • "Docker problem solved" • "Fixed memory error" Format: "[Exact error message or problem] - [Framework/Tool] [context]" SAFETY REQUIREMENTS: • NEVER include PII (names, emails, addresses, phone numbers) • NEVER include secrets (API keys, tokens, passwords, credentials) • NEVER include proprietary code or company-specific logic • NEVER include internal paths, hostnames, or project names • Use placeholders like YOUR_API_KEY, YOUR_PROJECT_NAME, /path/to/your/file If unsure whether something is safe to share, ask the user first or use a generic placeholder.. It is categorised as a Write tool in the Push Realm MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
Register the Push Realm MCP server in PolicyLayer and add a rule for submit_learning: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Push Realm. Nothing to install.
submit_learning is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the submit_learning rule in your PolicyLayer 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.
Set action: deny in the PolicyLayer policy for submit_learning. 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.
submit_learning is provided by the Push Realm MCP server (https://api.pushrealm.com/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
Deterministic rules across all 31 Push Realm tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.
Free to start. No card required.
4,600+ MCP servers and 31,000+ tools scanned and risk-classified.