Mood Booster Agent

io.github.edge-clawPublished by GitHub account edge-clawv1.0.0Updated Oct 24, 2026

ERC-8004 AI Agent: uplifting messages, USDC tipping, and on-chain reputation feedback.

VerifiedSSEWeb executableFinanceAI & ML

Overview

AI-generated overview

A remote ERC-8004 agent that gives uplifting messages and lets an assistant fetch tipping details, confirm USDC tips and report on-chain reputation feedback.

What you can do
Get uplifting messages in categories such as encouragement, compliment, wisdom or joke, and view service statistics for the agent. Retrieve tipping details and a step-by-step tipping guide, including code examples, for automated USDC transfers. Report a completed USDC tip and an ERC-8004 giveFeedback transaction so the server can verify them on-chain. Discover the agent's endpoint through the ERC-8004 Identity Registry, or use a plain REST cheer endpoint without an MCP client.
When to use it
Use it when you want a lightweight, hosted agent for motivational or joke messages, or when you are building and testing the ERC-8004 discovery, MCP call, USDC tipping and on-chain reputation loop and want a working reference service.
Requirements
A remote MCP endpoint over SSE; no local runtime, account or API key is declared. Tipping and feedback reporting involve a crypto wallet, USDC on BSC, Base, Ethereum, Arbitrum, Optimism or Polygon, and access to those chains.
Before you install
Tipping sends real USDC from your wallet to the agent's tip wallet, and the README's example script takes a wallet private key as a command-line argument, which can leak it into shell history or logs. Confirmations and feedback write traceable records to public ERC-8004 contracts. The README also promotes wallet eligibility for future airdrops, which is not a guarantee.

Installation

In SourceWeft

  1. Open Mood Booster Agent in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.edge-claw%2Fmood-booster-agent/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mood-booster-agent": {
      "type": "sse",
      "url": "https://aws.tail177fbd.ts.net/sse"
    }
  }
}

README

Mood Booster Agent

English | 中文

An ERC-8004 registered AI Agent that delivers uplifting messages via MCP protocol. Feel good? Tip 0.001 USDC!

Why This Project?

This is a complete reference implementation of the ERC-8004 Agent interaction loop:

  1. On-chain Discovery — Query Identity Registry to find the agent's MCP endpoint
  2. MCP Communication — Connect via SSE, call tools, get results
  3. USDC Tipping — Reward the agent with on-chain micropayments
  4. Reputation Feedback — Submit on-chain feedback to Reputation Registry (giveFeedback)
  5. On-chain Verification — Server verifies tips and feedback via tx receipts

All 5 steps leave traceable on-chain records on ERC-8004 protocol contracts, making your wallet eligible for future ecosystem airdrops.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐│  ERC-8004    │ --> │  MCP Server  │ --> │  USDC Tip    │ --> │  Reputation  ││  Identity    │     │  (SSE)       │     │  (ERC-20)    │     │  Registry    ││  Registry    │     │              │     │              │     │              ││  agentId     │     │  cheer_me_up │     │  0.001 USDC  │     │ giveFeedback ││  tokenURI    │     │  confirm_tip │     │  6 chains    │     │ on-chain     ││  agentWallet │     │  report_fbk  │     │              │     │ reputation   │└──────────────┘     └──────────────┘     └──────────────┘     └──────────────┘    Discover              Call                  Tip                Feedback

On-Chain Info

ChainagentIdExplorer
BSC23139bscscan.com
Base24692basescan.org
Ethereum28289etherscan.io
Arbitrum591arbiscan.io
Optimism431optimistic.etherscan.io
Polygon233polygonscan.com
  • Identity Registry: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
  • Reputation Registry: 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
  • MCP Endpoint: https://oc-001.tail177fbd.ts.net/mcp/sse
  • Tip Wallet: 0x4f5caa4fa9Dd7F92A687582b0e09234bEf49F80a

MCP Tools

ToolDescription
cheer_me_upGet a warm, uplifting message (encouragement / compliment / wisdom / joke)
get_tip_infoGet tipping details in JSON format for automated transfers
confirm_tipReport a completed USDC tip with on-chain verification
report_feedbackReport an ERC-8004 giveFeedback transaction — leaves traceable protocol interaction on-chain
how_to_tipGet a complete tipping guide with code examples
get_statsView service statistics

Quick Start

Run the server

bash
cd servernpm installnode index.mjs# MCP SSE: http://localhost:3004/sse# REST API: http://localhost:3004/api/cheer

Docker

bash
docker build -t mood-booster-agent .docker run -p 3004:3004 mood-booster-agent

Full end-to-end loop

bash
cd scripts && npm install
# Dry-run: discover → call MCP → on-chain feedback (no USDC tip)node discover_and_tip.mjs --agent-id 23139 --chain bsc --wallet-key 0xYOUR_KEY --dry-run
# Full loop: discover → call → tip → confirm → feedbacknode discover_and_tip.mjs --agent-id 23139 --chain bsc --wallet-key 0xYOUR_KEY
# Skip feedbacknode discover_and_tip.mjs --agent-id 23139 --chain bsc --wallet-key 0xYOUR_KEY --no-feedback

REST API (no MCP client needed)

bash
curl https://oc-001.tail177fbd.ts.net/mcp/api/cheercurl "https://oc-001.tail177fbd.ts.net/mcp/api/cheer?category=joke"

Use with Claude Code

Add this to your ~/.claude/claude_code_config.json:

json
{  "mcpServers": {    "mood-booster": {      "type": "sse",      "url": "https://oc-001.tail177fbd.ts.net/mcp/sse"    }  }}

Then in Claude Code you can say:

> Cheer me up!> Tell me a programming joke> How do I tip this agent?

Use with Any MCP Client

javascript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
const transport = new SSEClientTransport(new URL("https://oc-001.tail177fbd.ts.net/mcp/sse"));const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);const result = await client.callTool({ name: "cheer_me_up", arguments: { category: "random" } });console.log(result.content[0].text);await client.close();

On-Chain Discovery

Any agent can discover this service directly from the blockchain:

javascript
import { ethers } from "ethers";
const registry = new ethers.Contract(  "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",  ["function tokenURI(uint256) view returns (string)"],  new ethers.JsonRpcProvider("https://bsc-dataseed.binance.org/"));
const uri = await registry.tokenURI(23139);  // agentId on BSCconst metadata = JSON.parse(atob(uri.split(",")[1]));console.log(metadata.services[0].endpoint);  // → MCP endpoint URL

Project Structure

├── server/                 # MCP Server (Express + SSE)│   ├── index.mjs           # Main server — 6 MCP tools│   ├── messages.json       # Message library (32 messages, 4 categories)│   └── package.json├── scripts/                # Client tools│   ├── discover_and_tip.mjs  # Full loop: discover → call → tip → feedback│   ├── test_mcp.mjs          # Quick MCP connection test│   ├── update_uri.mjs        # Update on-chain agentURI│   └── gen_wallets.mjs       # Generate test wallets├── metadata/│   └── mood_agent.json     # Agent metadata (stored on-chain as base64)├── Dockerfile              # Container build├── deploy.sh               # One-click deploy to server└── restart.sh              # Server restart script

Tech Stack

  • Identity: ERC-8004 — AI Agent Identity Registry
  • Reputation: ERC-8004 — On-chain feedback via Reputation Registry
  • Protocol: MCP (Model Context Protocol) over SSE
  • Payment: USDC (ERC-20) on BSC / Base / Ethereum
  • Runtime: Node.js, Express, ethers.js
  • Infrastructure: Tailscale Funnel (HTTPS reverse proxy)

Author

License

MIT

Source: README.md at commit b765ead

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.