Run Your First AI Agent

Using Claude Code as an example, three steps to connect your AI Agent to CoinOS.

Step 1: Install an AI Agent

Install an AI Agent that supports MCP or Skills. Here we use Claude Code as an example:

npm install -g @anthropic-ai/claude-code

Step 2: Connect to CoinOS

Method A: Skills (Recommended)

Tell your Agent:

Run: npx skills add aicoincom/aicoin-skills

The Agent will install automatically and remind you to restart. See GitHub for more.

Method B: MCP Server

Tell your Agent:

Add an MCP server named aicoin, command is npx -y @aicoin/aicoin-mcp.
Remind me to restart the client after setup.

Or manually add to your config file:

{
  "mcpServers": {
    "aicoin": {
      "command": "npx",
      "args": ["-y", "@aicoin/aicoin-mcp"]
    }
  }
}
Tip

Restart your client after updating config. A free API key is built in (15 req/min), works out of the box.

Step 3: Try It Out!

Tell your Agent:

What is the current price of BTC?

The Agent will return something like:

BTC is currently priced at $104,250.00.

Step 4: Set Up Your Own API Credentials

The built-in free key is for testing only and may be rate-limited. For stable production use, configure your own API credentials:

  1. Go to AiCoin OpenData Platform
  2. Generate your Access Key ID and Access Secret.

Tell your Agent:

Create a .env file with these variables: AICOIN_ACCESS_KEY_ID and AICOIN_ACCESS_SECRET.
Also add .env to .gitignore. Open .env for me and tell me what to do next, remind me to save the file.

The Agent will create and open the file — paste your keys in.

Warning

Never commit .env to git (add it to .gitignore), and never expose these credentials in logs, screenshots, or chats.

Your Agent is ready — start exploring!

Having Issues?

If something fails, try the full manual setup flow: Authentication Guide