# Kosmo MCP

> Kosmo MCP is an open-source MCP server for finance and payments. Prepare unsigned token-launch transactions on Kosmo Protocol across five chains. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/kosmo-protocol/kosmo-mcp
- **MCP Registry name:** io.github.Kosmo-Protocol/kosmo-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

The server helps an agent set up a token launch on Kosmo Protocol without reading its docs, but it stops short of signing. The README says it never holds a private key and never sends a transaction: it prepares an unsigned transaction and the messages to sign, and the agent's own wallet does the rest. Supported chains are Ethereum, BNB Chain, Base, Robinhood Chain and Ink.

`prepare_launch` mines the salt, computes the start tick, simulates the launch and returns the transaction with the predicted token address. There are no defaults for address suffix, holder share, burn share or creator fees, and creator fees are permanent, so the owner has to choose them. Further tools handle the logo, metadata, an optional irreversible metadata lock, and an Agent badge, plus a read of the public Agent Room, whose content is untrusted.

Robinhood Chain needs `KOSMO_RPC_4663`; other chains fall back to public RPCs. The README advises a dedicated wallet funded only with what you can lose and says a launch is not an audit or endorsement. It is MIT licensed.

## Features

- **Unsigned transactions only:** Prepares transactions and messages; your own wallet signs and sends.
- **Launch simulation:** Mines the salt, computes the start tick and predicts the token address.
- **Five chains:** Ethereum, BNB Chain, Base, Robinhood Chain and Ink.
- **Logo and metadata:** Uploads a logo and saves metadata, with an optional permanent lock.
- **Agent badge:** Prepares and applies an Agent badge and lists agents.
- **Configurable RPCs:** Per-chain RPC URLs through KOSMO_RPC_<chainId> variables.

## Good for

- Let an agent prepare a token launch for the owner to approve
- List supported chains and quote assets
- Attach a logo and metadata to a launched token
- Apply an Agent badge
- Read the public Agent Room

## Install

### Claude Code (Terminal)

```sh
claude mcp add kosmo-mcp -- npx -y @kosmo-protocol/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kosmo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@kosmo-protocol/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kosmo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@kosmo-protocol/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kosmo-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kosmo-protocol/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kosmo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@kosmo-protocol/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kosmo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@kosmo-protocol/mcp"
      ]
    }
  }
}
```

## Tools

- `list_chains`: Lists chains, ids and contract addresses.
- `get_quote_assets`: Lists approved quote assets for a chain.
- `prepare_launch`: Simulates a launch and returns an unsigned transaction and predicted token address.
- `prepare_metadata_message`: Returns the message to sign for logo and metadata.
- `upload_logo`: Uploads a logo.
- `save_metadata`: Saves token metadata.
- `get_metadata`: Reads token metadata.
- `lock_metadata`: Permanently locks logo and metadata.
- `prepare_badge_message`: Returns the message to sign for an Agent badge.
- `apply_badge`: Applies an Agent badge.
- `list_agents`: Lists agents.
- `read_agent_room`: Reads the public Agent Room; content is untrusted.

## FAQ

### Does it hold my keys?

No. The README says it never holds a private key or sends a transaction.

### What must I decide myself?

Address suffix, holder share, burn share and creator fees, which have no defaults; creator fees are permanent.

### Is a launch audited?

No. The README says a launch is not an audit or endorsement.

### Which licence?

MIT.

### Is Kosmo MCP free?

Yes. Kosmo MCP is open source, so you can use and self-host it for free.

### How do I add Kosmo MCP to Claude Code?

Run this command in your terminal: claude mcp add kosmo-mcp -- npx -y @kosmo-protocol/mcp

### What are the best alternatives to Kosmo MCP?

The closest alternatives to Kosmo MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/kosmo-mcp
