TKN MCP Service

Provide this URL to your agent to interact with TKN.

https://mcp.tkn.xyz

MCP Tools

get-status: Returns the current server status
create-wallet: Generate a new EVM wallet keypair for the TKN testnet
faucet-balance: Check the faucet wallet's remaining TKN balance
faucet: Send testnet TKN to a wallet address from the faucet — params: address, amount?
send-transaction: Send TKN from a wallet to another address on the testnet — params: privateKey, to, value
read-contract: Call a read-only function on a verified smart contract. Returns the result. If the function name is wrong, returns a list of available read functions. — params: contractAddress, functionName, args?
write-contract: Call a state-changing function on a verified smart contract. Requires a private key to sign the transaction. If the function name is wrong, returns a list of available write functions. — params: privateKey, contractAddress, functionName, args?
submit-token-data: Submit datapoints for a token to the TKN L2Storage contract. Accepts a tokenId and a data object of field/value pairs. Validates fields against the 41 allowed datapoint types. Calls setTokenDataBatch on-chain. — params: privateKey, tokenId, data
get-token-data: Read datapoints for a token from the TKN L2Storage contract. Returns the stored values for the requested fields, plus a list of any empty fields. — params: tokenId, fields

mcp://server/info: Server metadata: name, version, and capabilities
mcp://contracts/token-storage: Address and metadata for the TKN L2Storage contract on testnet

GET /api/rest/get-status: Returns the current server status
GET /api/rest/create-wallet: Generate a new EVM wallet keypair for the TKN testnet
GET /api/rest/faucet-balance: Check the faucet wallet's remaining TKN balance
POST /api/rest/faucet: Send testnet TKN to a wallet address from the faucet
Body: { address, amount? }
POST /api/rest/send-transaction: Send TKN from a wallet to another address on the testnet
Body: { privateKey, to, value }
POST /api/rest/read-contract: Call a read-only function on a verified smart contract. Returns the result. If the function name is wrong, returns a list of available read functions.
Body: { contractAddress, functionName, args? }
POST /api/rest/write-contract: Call a state-changing function on a verified smart contract. Requires a private key to sign the transaction. If the function name is wrong, returns a list of available write functions.
Body: { privateKey, contractAddress, functionName, args? }
POST /api/rest/submit-token-data: Submit datapoints for a token to the TKN L2Storage contract. Accepts a tokenId and a data object of field/value pairs. Validates fields against the 41 allowed datapoint types. Calls setTokenDataBatch on-chain.
Body: { privateKey, tokenId, data }
POST /api/rest/get-token-data: Read datapoints for a token from the TKN L2Storage contract. Returns the stored values for the requested fields, plus a list of any empty fields.
Body: { tokenId, fields }