@ipfs-ninja/mcp-server

MCP server for IPFS Ninja — upload, pin, and manage IPFS files from Claude Code, Cursor, Windsurf, and any MCP-compatible AI tool.

Setup

Claude Code

Add to your project's .claude/settings.json or global ~/.claude/settings.json:

{
  "mcpServers": {
    "ipfs-ninja": {
      "command": "npx",
      "args": ["@ipfs-ninja/mcp-server"],
      "env": {
        "IPFS_NINJA_API_KEY": "bws_your_full_api_key_here"
      }
    }
  }
}

Cursor / Windsurf

Add to MCP settings (Settings > MCP Servers):

• Name: ipfs-ninja
• Command: npx @ipfs-ninja/mcp-server
• Environment: IPFS_NINJA_API_KEY=bws_...

Get your API key

1. Sign up at ipfs.ninja
2. Go to Dashboard > API Keys
3. Click Create API key — copy the full key immediately (shown only once)

Tools

| Tool | Description | |------|-------------| | ipfs_upload | Upload file content (base64 or text) to IPFS | | ipfs_upload_json | Upload a JSON object to IPFS | | ipfs_list | List your uploaded files | | ipfs_get | Get file metadata by CID | | ipfs_pin | Pin an existing CID from the IPFS network | | ipfs_pin_status | Check pin progress | | ipfs_delete | Unpin and delete a file | | ipfs_folders_list | List your folders | | ipfs_folders_create | Create a new folder | | ipfs_profile | Get account info (plan, storage, bandwidth) | | ipfs_analytics | Get usage analytics and daily bandwidth |

Examples

You: "Upload my package.json to IPFS"
AI:  [calls ipfs_upload with file content]
     → Uploaded! CID: QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

You: "How much storage am I using?"
AI:  [calls ipfs_profile]
     → Plan: Bodhi, Storage: 45.2 MB / 100 GB, Files: 230

You: "Pin bafyabc... from the IPFS network"
AI:  [calls ipfs_pin]
     → Pin initiated! Status: pinning

License

MIT