{
  "markdown": "# Uranium MCP Server\n\n<!-- BADGES:START -->\n### 🚀 Quick Install\n\n[<img src=\"https://img.shields.io/badge/VS_Code-0098FF?style=flat-square&logo=visual-studio-code&logoColor=white\" alt=\"Install in VS Code\">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522uranium%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uranium-tools-mcp%2540latest%2522%255D%252C%2522env%2522%253A%257B%2522URANIUM_API_KEY%2522%253A%2522your_api_key_here%2522%257D%257D%257D) [<img src=\"https://img.shields.io/badge/VS_Code_Insiders-24bfa5?style=flat-square&logo=visual-studio-code&logoColor=white\" alt=\"Install in VS Code Insiders\">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522uranium%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uranium-tools-mcp%2540latest%2522%255D%252C%2522env%2522%253A%257B%2522URANIUM_API_KEY%2522%253A%2522your_api_key_here%2522%257D%257D%257D) [<img src=\"https://img.shields.io/badge/Cursor-000000?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTggMEMzLjU4IDAgMCAzLjU4IDAgOFMzLjU4IDE2IDggMTZTMTYgMTIuNDIgMTYgOFMxMi40MiAwIDggMFpNOCAxNEM0LjY5IDE0IDIgMTEuMzEgMiA4UzQuNjkgMiA4IDJDOC41NSAyIDkuMDggMi4wOSA5LjU4IDIuMjRMOCA0TDEyIDhMOCAxMlY5TDUgMTJWNEw4IDdWNEw5LjU4IDIuMjRDMTIuODQgMy4yNCAxNSA1LjQgMTUgOEMxNSAxMS4zMSAxMS4zMSAxNCA4IDE0WiIgZmlsbD0id2hpdGUiLz4KPC9zdmc+\" alt=\"Install in Cursor\">](cursor://anysphere.cursor-deeplink/mcp/install?name=uranium&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJ1cmFuaXVtLXRvb2xzLW1jcEBsYXRlc3QiXSwiZW52Ijp7IlVSQU5JVU1fQVBJX0tFWSI6InlvdXJfYXBpX2tleV9oZXJlIn19) [<img src=\"https://img.shields.io/badge/Goose-FFA500?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTggMEMzLjU4IDAgMCAzLjU4IDAgOFMzLjU4IDE2IDggMTZTMTYgMTIuNDIgMTYgOFMxMi40MiAwIDggMFoiIGZpbGw9IndoaXRlIi8+Cjwvc3ZnPg==\" alt=\"Install in Goose\">](https://block.github.io/goose/extension?cmd=npx&arg=uranium-tools-mcp%40latest&id=uranium&name=Uranium&description=MCP%20for%20Uranium%20NFT%20tools%20to%20mint%2C%20list%2C%20and%20manage%20digital%20assets%20on%20the%20permaweb.) [<img src=\"https://img.shields.io/badge/LM_Studio-7B68EE?style=flat-square&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTggMEwxNiA0VjEyTDggMTZMMCAxMlY0TDggMFoiIGZpbGw9IndoaXRlIi8+Cjwvc3ZnPg==\" alt=\"Install in LM Studio\">](https://lmstudio.ai/install-mcp?name=uranium&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJ1cmFuaXVtLXRvb2xzLW1jcEBsYXRlc3QiXSwiZW52Ijp7IlVSQU5JVU1fQVBJX0tFWSI6InlvdXJfYXBpX2tleV9oZXJlIn19)\n<!-- BADGES:END -->\n\nA Model Context Protocol (MCP) server for working with [portal.uranium.pro](https://portal.uranium.pro) - creating and managing NFT collections and assets. This server enables LLMs to interact with blockchain NFTs through a simple, structured interface.\n\n### Key Features\n\n- **Fast and efficient NFT management**. Direct integration with Uranium API for instant operations.\n- **Multi-collection support**. Manage ERC721 and ERC1155 NFT collections seamlessly.\n- **File-based asset creation**. Upload images, videos, audio, and documents directly as NFTs.\n- **Bulk operations**. List and filter assets across multiple collections with pagination.\n\n### Requirements\n\n- Node.js 18 or newer\n- Uranium API key from [portal.uranium.pro](https://portal.uranium.pro/dashboard/profile/api-keys)\n- VS Code, Cursor, Windsurf, Claude Desktop, Goose or any other MCP client\n\n<!--\n// Generate using:\nnode utils/generate-readme.js\n-->\n\n### Getting Started\nFirst, install the Uranium MCP server with your client.\n\n**Standard config** works in most of the tools:\n\n```json\n{\n  \"mcpServers\": {\n    \"uranium\": {\n      \"command\": \"npx\",\n      \"args\": [\"uranium-tools-mcp@latest\"],\n      \"env\": {\n        \"URANIUM_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n<details>\n<summary>Claude Code</summary>\n\nUse the Claude Code CLI to add the Uranium MCP server:\n\n```bash\nclaude mcp add uranium npx uranium-tools-mcp@latest\n```\n\nThen set your URANIUM_API_KEY when prompted.\n</details>\n\n<details>\n<summary>Claude Desktop</summary>\n\nAdd to your Claude Desktop configuration file:\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- Linux: `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"uranium\": {\n      \"command\": \"npx\",\n      \"args\": [\"uranium-tools-mcp@latest\"],\n      \"env\": {\n        \"URANIUM_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary>Codex</summary>\n\nCreate or edit the configuration file `~/.codex/config.toml` and add:\n\n```toml\n[mcp_servers.uranium]\ncommand = \"npx\"\nargs = [\"uranium-tools-mcp@latest\"]\nenv = { URANIUM_API_KEY = \"your_api_key_here\" }\n```\n\nFor more information, see the [Codex MCP documentation](https://github.com/openai/codex/blob/main/codex-rs/config.md#mcp_servers).\n</details>\n\n<details>\n<summary>Cursor</summary>\n\n#### Click the button to install:\n\n[<img src=\"https://cursor.com/deeplink/mcp-install-dark.svg\" alt=\"Install in Cursor\">](cursor://anysphere.cursor-deeplink/mcp/install?name=uranium&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJ1cmFuaXVtLXRvb2xzLW1jcEBsYXRlc3QiXSwiZW52Ijp7IlVSQU5JVU1fQVBJX0tFWSI6InlvdXJfYXBpX2tleV9oZXJlIn19)\n\n#### Or install manually:\n\nGo to `Cursor Settings` -> `MCP` -> `Add new MCP Server`. Name it \"uranium\", use `command` type with the command `npx uranium-tools-mcp@latest`. Add environment variable `URANIUM_API_KEY` with your API key.\n\n</details>\n\n<details>\n<summary>Gemini CLI</summary>\n\nFollow the MCP install [guide](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md#configure-the-mcp-server-in-settingsjson), use the standard config above with your API key.\n\n</details>\n\n<details>\n<summary>Goose</summary>\n\n#### Click the button to install:\n\n[![Install in Goose](https://block.github.io/goose/img/extension-install-dark.svg)](https://block.github.io/goose/extension?cmd=npx&arg=uranium-tools-mcp%40latest&id=uranium&name=Uranium&description=MCP%20for%20Uranium%20NFT%20tools%20to%20mint%2C%20list%2C%20and%20manage%20digital%20assets%20on%20the%20permaweb.)\n\n#### Or install manually:\n\nGo to `Advanced settings` -> `Extensions` -> `Add custom extension`. Name it \"uranium\", use type `STDIO`, and set the `command` to `npx uranium-tools-mcp@latest`. Add environment variable `URANIUM_API_KEY` with your API key. Click \"Add Extension\".\n</details>\n\n<details>\n<summary>LM Studio</summary>\n\n#### Click the button to install:\n\n[![Add MCP Server uranium to LM Studio](https://files.lmstudio.ai/deeplink/mcp-install-light.svg)](https://lmstudio.ai/install-mcp?name=uranium&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJ1cmFuaXVtLXRvb2xzLW1jcEBsYXRlc3QiXSwiZW52Ijp7IlVSQU5JVU1fQVBJX0tFWSI6InlvdXJfYXBpX2tleV9oZXJlIn19)\n\n#### Or install manually:\n\nGo to `Program` in the right sidebar -> `Install` -> `Edit mcp.json`. Use the standard config above with your API key.\n</details>\n\n<details>\n<summary>opencode</summary>\n\nFollow the MCP Servers [documentation](https://opencode.ai/docs/mcp-servers/). For example in `~/.config/opencode/opencode.json`:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"mcp\": {\n    \"uranium\": {\n      \"type\": \"local\",\n      \"command\": [\n        \"npx\",\n        \"uranium-tools-mcp@latest\"\n      ],\n      \"env\": {\n        \"URANIUM_API_KEY\": \"your_api_key_here\"\n      },\n      \"enabled\": true\n    }\n  }\n}\n```\n</details>\n\n<details>\n<summary>Qodo Gen</summary>\n\nOpen [Qodo Gen](https://docs.qodo.ai/qodo-documentation/qodo-gen) chat panel in VSCode or IntelliJ → Connect more tools → + Add new MCP → Paste the standard config above with your API key.\n\nClick `Save`.\n</details>\n\n<details>\n<summary>VS Code</summary>\n\n#### Click the button to install:\n\n[<img src=\"https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF\" alt=\"Install in VS Code\">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522uranium%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uranium-tools-mcp%2540latest%2522%255D%252C%2522env%2522%253A%257B%2522URANIUM_API_KEY%2522%253A%2522your_api_key_here%2522%257D%257D%257D) [<img alt=\"Install in VS Code Insiders\" src=\"https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5\">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522uranium%2522%253A%257B%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522uranium-tools-mcp%2540latest%2522%255D%252C%2522env%2522%253A%257B%2522URANIUM_API_KEY%2522%253A%2522your_api_key_here%2522%257D%257D%257D)\n\n#### Or install manually:\n\nFollow the MCP install [guide](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server), use the standard config above. You can also install the Uranium MCP server using the VS Code CLI:\n\n```bash\n# For VS Code\ncode --add-mcp '{\"name\":\"uranium\",\"command\":\"npx\",\"args\":[\"uranium-tools-mcp@latest\"],\"env\":{\"URANIUM_API_KEY\":\"your_api_key_here\"}}'\n```\n\nAfter installation, the Uranium MCP server will be available for use with your GitHub Copilot agent in VS Code.\n</details>\n\n<details>\n<summary>Windsurf</summary>\n\nFollow Windsurf MCP [documentation](https://docs.windsurf.com/windsurf/cascade/mcp). Use the standard config above with your API key.\n\n</details>\n\n### Configuration\n\n#### Environment Variables\n\n- **`URANIUM_API_KEY`** (required): Your Uranium API key from [portal.uranium.pro](https://portal.uranium.pro/dashboard/profile/api-keys)\n- **`URANIUM_BASE_URL`** (optional): API base URL. Defaults to `https://gw.urnm.pro`\n\n#### Example Configuration\n\n```json\n{\n  \"mcpServers\": {\n    \"uranium\": {\n      \"command\": \"npx\",\n      \"args\": [\"uranium-tools-mcp@latest\"],\n      \"env\": {\n        \"URANIUM_API_KEY\": \"your_api_key_here\"\n        // URANIUM_BASE_URL is optional, defaults to https://gw.urnm.pro\n      }\n    }\n  }\n}\n```\n\n#### Local Installation\n\nIf you prefer to install locally:\n\n```bash\nnpm install -g uranium-tools-mcp\n# or\npnpm add -g uranium-tools-mcp\n# or\nyarn global add uranium-tools-mcp\n```\n\nThen use `uranium-tools-mcp` instead of `npx uranium-tools-mcp@latest` in the configuration.\n\n### Tools\n\n\n<!--- Tools generated by utils/generate-tools-docs.js -->\n\nThis MCP server provides 4 main tools for NFT management:\n\n<details>\n<summary><b>Collection Management</b></summary>\n\n#### list_collections\n- **Description**: List all user collections (personal, common, and external)\n- **Parameters**: None\n\n#### create_collection\n- **Description**: Create a new NFT collection\n- **Parameters**:\n  - `name` (string, required): Collection name (3-30 characters, letters, numbers, and [_.-] symbols) [min length: 3, max length: 30]\n  - `symbol` (string, required): Collection symbol (3-30 characters, letters, numbers, and underscores) [min length: 3, max length: 30]\n  - `type` (string, enum: ERC721, ERC1155, required): Collection type: ERC721 (single NFTs) or ERC1155 (multi-token)\n\n</details>\n\n<details>\n<summary><b>Asset Management</b></summary>\n\n#### list_assets\n- **Description**: List assets with optional filtering by collection, search, and pagination\n- **Parameters**:\n  - `contractId` (string, optional): Filter assets by collection ID\n  - `page` (number, optional): Page number (default: 1) [min: 1, default: 1]\n  - `pageSize` (number, optional): Number of assets per page (default: 20, max: 100) [min: 1, max: 100, default: 20]\n  - `sortBy` (string, optional): Sort field (default: createdAt) [default: \"createdAt\"]\n  - `order` (string, enum: asc, desc, optional): Sort order (default: asc) [default: \"asc\"]\n  - `quickFilter` (string, optional): Search text to filter assets by title\n\n#### create_asset\n- **Description**: Create a new NFT asset from a local file or base64 data\n- **Parameters**:\n  - `filePath` (string, optional): Absolute path to the media file (for local files)\n  - `fileData` (string, optional): Base64 encoded file data (for Claude Desktop)\n  - `fileName` (string, optional): Original filename (required when using fileData)\n  - `mimeType` (string, optional): MIME type of the file (required when using fileData, e.g., 'image/png')\n  - `contractId` (string, required): ID of the collection to mint the asset in\n  - `title` (string, required): Asset title (3-120 characters) [min length: 3, max length: 120]\n  - `description` (string, optional): Asset description (optional, max 255 characters) [max length: 255]\n  - `location` (string, optional): Location where the asset was created (optional, max 100 characters) [max length: 100]\n  - `editions` (number, optional): Number of editions (for ERC1155 collections only, 1-1000) [min: 1, max: 1000]\n  - `shareWithCommunity` (boolean, optional): Make the asset discoverable by the community (optional, default: false) [default: false]\n\n</details>\n\n<!--- End of tools generated section -->\n\n### Supported File Formats\n\n- **Images**: JPG, JPEG, PNG, GIF, WebP, SVG\n- **Video**: MP4, WebM, MOV, AVI\n- **Audio**: MP3, WAV, OGG\n- **Documents**: PDF, TXT\n\n### Development\n\n#### Building from Source\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/xkelxmc/uranium-mcp.git\ncd uranium-mcp\n```\n\n2. Install dependencies:\n\n```bash\nnpm install\n```\n\n3. Build the project:\n\n```bash\nnpm run build\n```\n\n#### Development Commands\n\n```bash\n# Compile in watch mode\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Start server locally\nnpm start\n\n# Clean build directory\nnpm run clean\n```\n\n### Testing\n\n#### Using MCP Inspector\n\nTest your MCP server with the [MCP Inspector](https://modelcontextprotocol.io/tools/inspector):\n\n```bash\n# For installed version\nnpx @modelcontextprotocol/inspector uranium-tools-mcp\n\n# For local development\nnpm run build:dev\nnpx @modelcontextprotocol/inspector node build/index.js\n```\n\n#### Development Testing\n\n```bash\n# Test with stdio transport\nnpm run dev:stdio\n\n# Test with HTTP transport\nnpm run dev:http\n\n# Inspect with HTTP transport\nnpm run mcp:inspect\n```\n\n### Troubleshooting\n\n#### Common Issues\n\n1. **API Key not working**: Make sure your API key is valid and has the necessary permissions at [portal.uranium.pro](https://portal.uranium.pro/dashboard/profile/api-keys)\n\n2. **Connection errors**: Check that the URANIUM_BASE_URL is correct (defaults to `https://gw.urnm.pro`)\n\n3. **File upload issues**: Ensure the file path is absolute and the file exists\n\n4. **Collection creation fails**: Verify that collection names and symbols follow the required format (3-30 characters, alphanumeric and underscore)\n\n### Project Structure\n\n```\nsrc/\n├── api/           # Complete copy of Uranium API from Raycast\n├── utils/         # Utilities for validation, formatting, etc.\n├── models/        # Upload primitives for working with files\n├── tools/         # MCP tools\n├── server.ts      # MCP server configuration\n├── index.ts       # Entry point\n└── config.ts      # API and MCP configuration\n```\n\n### License\n\ntodo\n\n### Support\n\nFor issues and questions:\n\n- Contact support at [uranium.pro](https://uranium.pro)\n",
  "bytes": 15465,
  "sha": "505c5c0ce6b02c942490eb032ea994e8caa3cd50bac666c7a65008b0f0cddbe2",
  "repo_slug": "xkelxmc/uranium-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_xkelxmc_uranium_mcp_35722bdd/readme"
}