# Toket MCP

> Toket lets you manage your entire Web3 asset lifecycle using a single checkout widget that accepts crypto payments like Bitcoin and Ethereum. Connect this MCP Server to deploy NFT collections, mint digital assets, check transaction status, monitor gas balances, and list all your holdings—all through natural conversation with your AI agent.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** nft-minting, web3, smart-contracts, crypto-payments, digital-assets, blockchain-integration

## Description

Yo, check it. You connect this MCP Server and you're running your whole Web3 operation right from your chat window. It manages everything—from deploying a brand-new NFT collection contract to handling payments in Bitcoin or Ethereum. This server lets your AI agent handle the entire asset lifecycle for you. You don't gotta leave the conversation to mint, check balances, or list what you got.

***Deployment and Setup***

Need to start a new project? Use **`create_collection`**; it handles deploying an ERC-721 smart contract. You just give it a name, a symbol, and the owner wallet address, and boom—you've got a collection deployed. If you want to see what collections already exist under your account, run **`list_collections`**. For deep details on any specific, existing NFT project, use **`get_collection`**; it pulls all the metadata for that contract.

***Minting Assets***

When you're ready to drop some NFTs, you got two ways to go. If you know exactly what parameters you need—the full collection details and everything—use **`mint_nft`**. That initiates a proper mint into a defined contract. But if it’s just for rewards or giveaways and you don't want all those strict parameters, use **`easy_mint`** instead; it quickly generates the asset for a recipient. To see every single individual NFT you’ve minted under your account, run **`list_mints`**. You can also check what assets are associated with your overall account by running **`list_collections`**.

***Monitoring and Status Checks***

You gotta know if the transaction actually worked. If you initiate a minting process, use **`get_mint_status`** to pull the live status of that transaction; it tells you flat out whether it succeeded or failed on the blockchain. Before you start any automated minting operations, check your funds first. Use **`get_gas_tank_status`**. This function checks your current Gas Tank balance so you can plan how many assets you can actually afford to mint.

***What You Get***

When your agent uses these tools, it gives you actionable data. Running `list_mints` shows the history of every digital asset distribution event tied to your account. When you check a collection with **`get_collection`**, you get detailed metadata about that specific contract. This whole setup lets your AI client talk directly to Web3 services, managing deployment and payments without any hassle or technical jargon. It's all done through natural conversation.

## Tools

### create_collection
Deploys a new NFT collection by requiring you to specify the name, symbol, and owner wallet address.

### easy_mint
Performs a quick mint of an NFT asset for a recipient when you don't need full contract parameters.

### get_collection
Retrieves detailed metadata about one specific, existing NFT collection.

### get_gas_tank_status
Checks your current Gas Tank balance to estimate funds available for automated minting operations.

### get_mint_status
Gathers the live status of a specific NFT minting transaction, confirming if it succeeded or failed.

### list_collections
Retrieves a full list of all NFT collections associated with your account.

### list_mints
Lists every single individual NFT asset that has been minted under your account's ownership.

### mint_nft
Initiates the process of minting an NFT into a specific, defined collection using full parameters.

## Prompt Examples

**Prompt:** 
```
List all NFT collections in my account.
```

**Response:** 
```
I've retrieved your NFT collections. You have 3 active contracts: 'Vinkius Founders', 'Beta Access Pass', and 'Event Reward 2024'. Which one would you like to mint an asset into?
```

**Prompt:** 
```
Mint a Founders NFT to the address '0x123...456'.
```

**Response:** 
```
Minting initiated! I've triggered a new NFT creation for the Founders collection to the recipient 0x123...456. The transaction ID is mint_88231. I'll monitor its status on the blockchain for you.
```

**Prompt:** 
```
Check the current status of my Gas Tank.
```

**Response:** 
```
Fetching status... Your Gas Tank currently has 0.15 ETH (approx. 500 transactions). You have plenty of balance for upcoming automated minting operations.
```

## Capabilities

### Deploy new NFT collections
Create a brand-new ERC-721 smart contract for your project by providing the collection name, symbol, and owner wallet.

### Quickly generate NFTs
Mint an asset into a specified collection without needing full parameters—it's fast, perfect for rewards or giveaways.

### Check transaction status
Retrieve the current state of any initiated minting process to confirm successful blockchain delivery.

### List all collections and assets
Get a complete inventory of every NFT collection deployed and every individual asset minted under your account.

### Monitor gas funds
Check the current balance and status of your Gas Tank to plan automated minting operations.

## Use Cases

### Launching a new loyalty program
The project owner needs 500 reward NFTs created for early backers. Instead of manually setting up 500 individual transactions, they ask the agent to use `create_collection` first, then run `easy_mint` in batches, and finally check deployment via `get_mint_status`. The entire process is tracked in one chat thread.

### Auditing a major campaign payout
The marketing team needs to confirm if 50 different users received their promised assets. They use the agent to run `list_mints` and then cross-reference the results against expected IDs, confirming that all transactions were logged successfully.

### Checking project readiness
A developer needs to know if a new contract is ready for deployment. They first use `list_collections` to confirm existing assets and then use `get_collection` on the target contract ID to pull all necessary metadata before calling `mint_nft`.

### Preventing operational downtime
Before scheduling a high-volume automated mint, an engineer checks their limits by running `get_gas_tank_status`. This prevents the system from failing mid-operation due to insufficient funds.

## Benefits

- Instantly deploy new collections: Instead of writing contract deployment scripts, you just tell your agent to use `create_collection` with the name and symbol. Done.
- Simplify asset distribution: Need 100 rewards minted? Use `easy_mint`. You don't have to manually pass parameters for every single NFT; it’s a quick call.
- Know exactly what happened: After a minting job, check the status using `get_mint_status`. This tells you if the transaction succeeded on the chain or if something broke.
- Keep track of everything: You can run `list_collections` to see your entire portfolio at a glance. It's one command for all your deployed assets.
- Manage resources proactively: Don't get stuck mid-campaign because you ran out of gas. Run `get_gas_tank_status` first to know what you’re working with.

## How It Works

The bottom line is, you talk to your AI client, and it executes complex Web3 actions like contract deployment and asset minting using the server's tools.

1. Subscribe to the Toket MCP Server on Vinkius.
2. Input your unique Toket API Key into your AI client's settings.
3. Tell your agent what you want to do. For example: 'List all my NFT collections,' or 'Mint a Founders NFT.' The server runs the necessary tool and gives you the result.

## Frequently Asked Questions

**How do I start a new NFT collection with Toket?**
You initiate deployment by calling the `create_collection` tool, providing the required name, symbol, and owner wallet address. The agent handles the smart contract setup for you.

**Is using `easy_mint` faster than `mint_nft`?**
Yes. `easy_mint` is designed for quick rewards or giveaways where full parameters aren't needed, saving time over the more detailed process of calling `mint_nft`.

**What should I use if my minting transaction fails?**
Always check with `get_mint_status`. This tool reports on the specific failure point—whether it was a gas issue, an address error, or a smart contract rejection.

**Can Toket help me see all my deployed collections?**
Absolutely. The `list_collections` tool retrieves every active NFT collection associated with your account ID in one single API call.

**What does running `get_gas_tank_status` show me about my automated minting capabilities?**
It provides a real-time reading of your Gas Tank balance. This check tells you exactly how much operational capacity remains for any scheduled or manual minting processes, letting you plan ahead.

**How do I retrieve detailed metadata when using `get_collection`?**
The tool pulls deep structural data beyond just the collection name. You get access to comprehensive details about the contract's rules and assets stored within that specific collection.

**If I want a full audit of my generated assets, should I use `list_mints`?**
Yes, `list_mints` displays every NFT you’ve successfully minted. It provides a detailed roster including the asset IDs and their corresponding recipient addresses.

**What specific inputs do I need to provide when calling `create_collection`?**
The server requires three key pieces of information: the collection's name, its unique symbol, and the owner wallet address. These are mandatory parameters for successful deployment.

**Can I deploy a new NFT collection using the AI?**
Yes! Use the `create_collection` action. Provide a name, symbol, and the owner wallet address. Your agent will deploy a new ERC-721 smart contract instantly.

**How do I check my remaining balance for transaction fees (Gas)?**
Run the `get_gas_tank_status` query. The agent will retrieve your current Gas Tank balance to ensure you have enough funds for automated minting.

**Is it possible to track the status of an NFT minting process?**
Absolutely. Use the `get_mint_status` tool and provide the Transaction ID. Your agent will return the real-time status of the blockchain interaction.