# Munition

> Munition is agentic x402 infrastructure for small paid services, anonymous accounts, and per-account USDC wallet funding on Base. Direct x402 and MPP routes also accept payment in USDC on Polygon, Arbitrum, and (x402 only) Solana.

Munition is the infrastructure. Services live inside it. Current services include Munition Upload for temporary public file URLs, Munition Flight Search for live flight offers, Munition Airport Search for airport reference data, and Munition Flight Offer Details for paid offer lookups.

Important facts:

- Install the MCP server with `npx -y @munition/mcp`.
- Production API origin is `https://api.munition.io`.
- Direct x402 Upload endpoint is `POST https://api.munition.io/v1/uploads`; direct x402 accepts Base, Polygon, Arbitrum, and Solana USDC.
- `@munition/mcp` is a local stdio MCP server; ChatGPT Web and Claude Web need a documented remote MCP endpoint instead of the npm package.
- Account state is local and anonymous, stored by the MCP server at `~/.munition/config.json`.
- Account-funded MCP service calls settle from the account USDC wallet on Base using x402. Direct paid HTTP routes can instead be paid with USDC on Base, Polygon, Arbitrum, or Solana for x402, and Base, Polygon, or Arbitrum for MPP.
- Current services: Munition Upload, Munition Flight Search, Munition Airport Search, and Munition Flight Offer Details.
- Uploaded files are public to anyone with the URL and retained for 7 days by default.
- Uploads can include optional `tags` metadata: an array of up to 20 non-empty strings, each 64 characters or shorter. Tags are returned by upload responses and recent upload history.
- 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.
- [Munition Upload](https://munition.io/upload): Human-facing service page for the current Upload service.
- [MCP package](https://www.npmjs.com/package/@munition/mcp): Public npm package for the local stdio MCP server.
- [MCP Registry metadata](https://api.munition.io/.well-known/mcp-server.json): Machine-readable package, transport, and install metadata.
- [API discovery](https://api.munition.io/.well-known/mcp.json): Munition-specific discovery document with tool and pricing links.
- [API catalog](https://api.munition.io/.well-known/api-catalog): RFC 9727-style API catalog linking Munition's agent-facing specs, docs, pricing, and x402 resources.
- [APIs.json](https://api.munition.io/apis.json): Sitemap-style machine-readable API directory for API crawlers and agent registries.
- [x402 resources](https://api.munition.io/.well-known/x402.json): Munition x402-compatible resources and supporting endpoints.
- [API-hosted llms.txt](https://api.munition.io/llms.txt): Compact agent guide colocated with the API origin.
- [OpenAPI spec](https://api.munition.io/openapi.json): HTTP API reference used by the MCP package.
- [Pricing API](https://api.munition.io/v1/tools/prices): Current machine-readable upload and renewal prices.
- [Direct Upload API](https://api.munition.io/v1/uploads): x402/Bazaar HTTP endpoint for buying upload slots directly with USDC on Base, Polygon, Arbitrum, or Solana.

## Install

- [Cursor one-click install](https://cursor.com/en/install-mcp?name=munition&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtdW5pdGlvbi9tY3AiXSwiZW52Ijp7Ik1VTklUSU9OX0FQSV9VUkwiOiJodHRwczovL2FwaS5tdW5pdGlvbi5pbyJ9fQ%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.
- [Remote connector guidance](https://munition.io/skill.md): ChatGPT Web and Claude Web guidance for remote MCP clients.

Manual production config:

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

## Current Services

- [Munition Upload](https://munition.io/upload): Publish local files from agent workflows and return public URLs for browsers, webhooks, tests, or collaborators. Direct route cost: 0.005 USDC via x402 on Base/Polygon/Arbitrum/Solana or MPP on Base/Polygon/Arbitrum.
- [Munition Flight Search](https://api.munition.io/v1/flights/search): Search live flight offers. Direct route cost: 0.05 USDC via x402 on Base/Polygon/Arbitrum/Solana or MPP on Base/Polygon/Arbitrum.
- [Munition Airport Search](https://api.munition.io/v1/airports/search): Search normalized airport reference data. Direct route cost: 0.001 USDC via x402 on Base/Polygon/Arbitrum/Solana; MPP is not advertised for this route.
- [Munition Flight Offer Details](https://api.munition.io/v1/flights/offers/{id}): Fetch normalized details for a Duffel flight offer. Direct route cost: 0.01 USDC via x402 on Base/Polygon/Arbitrum/Solana; MPP is not advertised for this route.
- Direct upload renew/delete routes support x402 on Base/Polygon/Arbitrum/Solana and MPP on Base/Polygon/Arbitrum. Account-funded MCP top-up remains Base-only.

## Upload Tools

- [upload](https://munition.io/skill.md): Upload a local file up to 10 MB and return a public URL plus optional tags metadata, 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.

## Marketing SEO Guides

- [Codex MCP](https://munition.io/codex-mcp): Configure Codex or Codex CLI MCP with Munition Upload.
- [MCP file upload](https://munition.io/mcp-file-upload): MCP file upload server for agents that need public artifact URLs.
- [Claude Code MCP](https://munition.io/claude-code-mcp): Give Claude Code a paid file upload tool.
- [ChatGPT MCP](https://munition.io/chatgpt-mcp): Use Munition MCP patterns with ChatGPT Developer Mode when available.
- [Cursor MCP](https://munition.io/cursor-mcp): Upload files from Cursor with Munition MCP.
- [x402 MCP](https://munition.io/x402-mcp): Paid MCP tools with x402 settlement and receipts.
- [AI agent payments](https://munition.io/ai-agent-payments): Practical pay-per-call tool payments for agents.
- [Claude Desktop MCP](https://munition.io/claude-desktop-mcp): Add Munition tools to Claude Desktop.
- [File upload API for agents](https://munition.io/file-upload-api-for-agents): Agent-native upload API positioning and limits.
- [AI agent tools](https://munition.io/ai-agent-tools): Current and coming Munition tools for real-world agent actions.

## 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.