Kreato MCP Server

Connect any AI agent (Claude, GPT, custom agents) to Kreato — letting users tip creators, buy digital products, and manage memberships through natural language.

What it does

Once deployed, a user can tell Claude:

"Tip @alexbuilds 5 USDC on Base" "Buy the Web3 Dev Guide from @alexbuilds" "Show me my earnings for the last 30 days" "Find Web3 developers selling courses under $20"

And it just works — on-chain, directly to the creator's wallet.

Quick start

1. Clone and install

git clone https://github.com/kreatospace/kreato-mcp
cd kreato-mcp
npm install

2. Configure environment

cp .env.example .env

Fill in .env:

KREATO_API_URL=https://api.kreato.space/v1
KREATO_API_SECRET=your_server_secret

PORT=3000
MCP_SERVER_URL=https://mcp.kreato.space

OAUTH_CLIENT_ID=your_oauth_client_id
OAUTH_CLIENT_SECRET=your_oauth_client_secret
OAUTH_REDIRECT_URI=https://mcp.kreato.space/oauth/callback

Get your KREATO_API_SECRET and OAuth credentials from the Kreato developer dashboard.

3. Run locally

npm run dev

Server starts at http://localhost:3000.

4. Test with Claude Desktop (local)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kreato": {
      "command": "node",
      "args": ["/absolute/path/to/kreato-mcp/src/index.js"],
      "env": {
        "KREATO_API_URL": "https://api.kreato.space/v1",
        "KREATO_API_SECRET": "your_secret"
      }
    }
  }
}

Restart Claude Desktop and you'll see the Kreato tools available.

Deploy to production

Railway (recommended — one click)

# Install Railway CLI
npm install -g @railway/cli

# Login and deploy
railway login
railway init
railway up

Set env vars in the Railway dashboard, then set your custom domain to mcp.kreato.space.

Docker

docker build -t kreato-mcp .
docker run -p 3000:3000 --env-file .env kreato-mcp

Fly.io

fly launch
fly secrets set KREATO_API_SECRET=xxx OAUTH_CLIENT_SECRET=xxx
fly deploy

MCP tools reference

Auth flow

Protected tools trigger an OAuth flow automatically:

1. Agent calls send_donation without a connected account

2. MCP server returns auth_required with a login URL

3. User clicks the link, logs in on kreato.space, grants permission

4. User returns to the AI — the agent retries automatically

Submit to Anthropic's MCP directory

Once your server is live and stable, submit it at: https://github.com/modelcontextprotocol/servers

Include:

• Server URL: https://mcp.kreato.space/sse

• Name: Kreato

• Description: "Web3 creator monetization — tip creators, buy digital products, manage memberships in crypto"

• Auth type: OAuth 2.0

Project structure

kreato-mcp/
├── src/
│   ├── index.js          # Express server + SSE transport
│   ├── tools.js          # All MCP tool definitions
│   ├── kreato-client.js  # Kreato REST API wrapper
│   └── oauth.js          # OAuth 2.0 flow handler
├── .env.example
├── Dockerfile
└── README.md