# Munition

> Munition gives AI agents x402-paid file upload tools through a local MCP server, anonymous accounts, and USDC wallet funding on Base.

Munition is for agent workflows that need to turn a local artifact into a public URL without giving the agent a provider API key. The first available service is Munition Upload.

Important facts:

- Install the MCP server with `npx -y @munition/mcp`.
- Production API origin is `https://mcp.munition.io`.
- Account state is local and anonymous, stored by the MCP server at `~/.munition/config.json`.
- Paid calls settle from the account USDC wallet on Base using x402.
- Uploaded files are public to anyone with the URL and retained for 7 days by default.
- Do not upload secrets, private keys, regulated data, or files that should not be public by link.

## Agent Entry Points

- [Munition skill](https://munition.io/skill.md): Primary setup and usage instructions for agents, including install commands, tool list, prompts, pricing, and troubleshooting.
- [MCP package](https://www.npmjs.com/package/@munition/mcp): Public npm package for the local stdio MCP server.
- [MCP Registry metadata](https://mcp.munition.io/.well-known/mcp-server.json): Machine-readable package, transport, and install metadata.
- [API discovery](https://mcp.munition.io/.well-known/mcp.json): Munition-specific discovery document with tool and pricing links.
- [OpenAPI spec](https://mcp.munition.io/openapi.json): HTTP API reference used by the MCP package.
- [Pricing API](https://mcp.munition.io/v1/tools/prices): Current machine-readable upload and renewal prices.

## Install

- [Cursor one-click install](https://cursor.com/en/install-mcp?name=munition&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtdW5pdGlvbi9tY3AiXSwiZW52Ijp7Ik1VTklUSU9OX0FQSV9VUkwiOiJodHRwczovL21jcC5tdW5pdGlvbi5pbyJ9fQ%3D%3D): Opens Cursor's MCP install flow.
- [Manual MCP config](https://munition.io/skill.md): JSON config for MCP clients that can run local stdio servers.

Manual production config:

```json
{
  "mcpServers": {
    "munition": {
      "command": "npx",
      "args": ["-y", "@munition/mcp"],
      "env": {
        "MUNITION_API_URL": "https://mcp.munition.io"
      }
    }
  }
}
```

## Tools

- [upload](https://munition.io/skill.md): Upload a local file up to 10 MB and return a public URL retained for 7 days. Cost: 0.005 USDC.
- [renew_upload](https://munition.io/skill.md): Extend an uploaded file by 7 more days. Cost: 0.005 USDC.
- [delete_upload](https://munition.io/skill.md): Delete a previously uploaded file. Free.
- [recent_uploads](https://munition.io/skill.md): List recent non-deleted uploads. Free.
- [balance](https://munition.io/skill.md): Return the account USDC wallet balance. Free.
- [topup_link](https://munition.io/skill.md): Return a deposit URL for funding the account x402 wallet. Free.
- [setup_link](https://munition.io/skill.md): Reset local anonymous account state and return a fresh deposit link. Free.

## Legal

- [Terms](https://munition.io/terms): Terms of service.
- [Privacy](https://munition.io/privacy): Privacy policy.

## Optional

- [Homepage](https://munition.io): Human-facing product page and setup prompt.
- [Files CDN](https://files.munition.io): Public upload delivery origin.