Tip.md provides a user-friendly interface for setting up wallets, generating tipping button snippets (markdown/HTML), viewing donation history, and discovering trending developers. It supports multiple blockchains with automated fee distribution and includes a native Farcaster mini app for seamless social tipping within Farcaster, plus an MCP server for AI assistant integration. *This llms.txt file helps LLMs understand the core features and documentation structure of the Tip.md platform.* # Getting Started with Tip.md ## Overview Tip.md is a platform that allows developers to receive cryptocurrency tips directly to their wallets. This guide will help you set up your account and configure your initial wallet settings. ## Account Setup 1. **Create an Account** - Visit [tip.md](https://tip.md) - Click "Sign Up" in the top right corner - Connect using your GitHub account or email 2. **Verify Your Identity** - Complete the basic profile information - Verify your email address through the confirmation link ## Initial Wallet Configuration 1. **Add Your First Wallet** - Navigate to "Wallet Settings" from your dashboard - Select a blockchain (Ethereum/Base, Solana, or Bitcoin Lightning) - Enter your wallet address or connect via Web3 wallet extension 2. **Set Default Payment Method** - Choose which cryptocurrency you prefer to receive by default - This will be highlighted on your tipping button 3. **Configure Split Settings (Optional)** - For Ethereum payments, you can set up automatic splits via Splits.org - Specify percentages to distribute to multiple addresses ## Next Steps Once your account and wallet are configured, you're ready to: - [Set up your tipping button](button-setup.md) - Learn about [receiving tips](receiving-tips.md) - Manage your [wallet settings](wallet-management.md) If you encounter any issues during setup, please check our [FAQ](faq.md) or contact support at support@tip.md. # Adding the Tip.md Button to Your Content ## Overview The Tip.md button allows your audience to send cryptocurrency tips directly from your content. This guide explains how to generate and add the button to various platforms. ## Generating Your Button 1. **Access Button Generator** - Log in to your Tip.md dashboard - Navigate to "Button Setup" 2. **Customize Your Button** - Choose button size (small, medium, large) - Select display options (show supported currencies, custom text) - Set your primary payment method 3. **Get Your Button Code** - The platform will generate both Markdown and HTML versions of your button code - Copy the appropriate format for your platform ## Adding to GitHub README ```markdown [](https://tip.md/your-username) ``` - Place this code anywhere in your README.md file - Visitors will see a button that links directly to your tipping page ## Adding to Website or Blog ### HTML Option ```html ``` ### Markdown Option (for markdown-based blogs) ```markdown [](https://tip.md/your-username) ``` ## Testing Your Button After adding your button: 1. View your content as a visitor would see it 2. Click the button to ensure it directs to your proper tipping page 3. Test a small transaction to verify the full flow works correctly ## Next Steps - Learn about [receiving tips](receiving-tips.md) - Set up additional [wallet options](wallet-management.md) - Check our [FAQ](faq.md) for common questions # Receiving Tips on Tip.md ## How Donations Work Tip.md creates a streamlined tipping experience for both creators and supporters: 1. **Supporter Experience** - Supporter clicks your Tip.md button - They select a cryptocurrency and amount - Transaction happens directly from their wallet to yours - No account creation required for supporters 2. **Transaction Flow** - For Ethereum, Base, and Solana: direct on-chain transfers - For Bitcoin: Lightning Network payments - All transactions are processed client-side for maximum security 3. **Confirmation Process** - Tips appear in your dashboard history immediately - Blockchain confirmations depend on the network used ## Fee Structure Tip.md operates with a simple and transparent fee model: | Currency | Platform Fee | Gas/Network Fees | Total | |----------|-------------|------------------|-------| | ETH (Ethereum) | 4% | Paid by sender | 4% | | USDC (Ethereum) | 4% | Paid by sender | 4% | | ETH (Base) | 4% | Paid by sender | 4% | | USDC (Base) | 4% | Paid by sender | 4% | | SOL (Solana) | 4% | Paid by sender | 4% | | USDC (Solana) | 4% | Paid by sender | 4% | | Bitcoin Lightning | 4% | Paid by sender | 4% | - No hidden charges or subscription costs - No minimum withdrawal amounts - Network transaction fees are paid by the sender ## Viewing Your Donation History 1. **Dashboard Overview** - Log in to your Tip.md account - The main dashboard shows recent tips and total received 2. **Detailed History** - Navigate to "Transaction History" - View your complete tip history - See transaction details for each tip ## Withdrawal Information - Tip.md never holds your funds - All tips go directly to the wallet addresses you've specified - You can manage or change your wallet addresses at any time through the [Wallet Management](wallet-management.md) section ## Tax Considerations - Tips received are typically considered taxable income in most jurisdictions - Tip.md provides downloadable transaction records for tax reporting via a simple request to support@tip.md - Consult with a tax professional regarding your specific situation ## Next Steps - Learn about [wallet management](wallet-management.md) - Check our [FAQ](faq.md) for common questions - Return to [Getting Started](getting-started.md) # Wallet Management on Tip.md ## Supported Blockchains Tip.md currently supports four major blockchain ecosystems: ### Ethereum - Support for Ethereum mainnet - Supported tokens: ETH (native) and USDC - Compatible with any ERC-20 compliant wallet - Integration with Splits.org for automatic fee distribution - Gas fees paid by the tipper ### Base - EVM-compatible blockchain with significantly lower fees than Ethereum mainnet - Supported tokens: ETH (native) and USDC - Compatible with any ERC-20 compliant wallet - Integration with Splits.org for automatic fee distribution - Lower gas fees paid by the tipper ### Solana - Fast transactions with minimal fees - Supported tokens: SOL (native) and USDC - Compatible with Phantom, Solflare, and other Solana wallets - Direct transfers to your Solana wallet address ### Bitcoin Lightning Network - Instant Bitcoin payments with minimal fees - Requires a Lightning-compatible wallet or node - LNURL support for simplified payments - No on-chain transaction delays ## Managing Your Wallet Addresses ### Adding a New Wallet 1. Navigate to "Wallet Settings" in your dashboard 2. Click "Add New Wallet" 3. Select the blockchain type 4. Enter your wallet address or connect via Web3 wallet extension 5. Verify the address with a test transaction (recommended) ### Updating Existing Wallets 1. Go to "Wallet Settings" 2. Find the wallet you wish to update 3. Click "Edit" 4. Make your changes and save 5. All future tips will go to the updated address ### Wallet Security Best Practices - Always double-check addresses when entering them - Consider using hardware wallets for added security - Enable email notifications for all transactions - Regularly review your active wallet addresses ## Split Settings (Ethereum and Base Only) Tip.md automatically deploys a secure smart contract on Ethereum and Base using Splits.org to handle fee distribution: 1. **Adding Your Ethereum or Base Address** - Enter your Ethereum or Base address in the Wallet Settings tab - Click the "Deploy Split" button next to your address 2. **Deploying the Split Contract** - Connect your MetaMask wallet when prompted - Confirm the transaction in your wallet to deploy the contract - You'll need to have ETH (for Ethereum) or ETH (for Base) in your wallet to cover the gas fees 3. **How Splits Work** - A secure, audited smart contract is deployed on the Ethereum or Base network - Incoming tips are automatically split: - 96% goes directly to your wallet - 4% goes to the platform (we only make money if you do) - The split contract handles distribution on-chain - You can view your contract on the blockchain explorer Note: If you change your Ethereum or Base address, you'll need to deploy a new Split contract. The old contract will remain active but won't receive new tips. ## Default Payment Method - Set your preferred blockchain as the default payment option - This currency will be highlighted when supporters visit your tip page - You can change your default payment method at any time ## Next Steps - Return to [Getting Started](getting-started.md) - Learn about [Button Setup](button-setup.md) - Check our [FAQ](faq.md) for common questions # Connect to tip.md's MCP Service ## What is the MCP Service? The Model Context Protocol (MCP) service allows AI assistants like Claude and Cursor to interact with tip.md's crypto tipping functionality directly. This enables your AI assistant to help users tip creators in cryptocurrency without leaving their chat interface. ### Available Tools Our MCP server provides the following tools for AI assistants: - **`tip_user_x402`** - Advanced tipping using x402 payment protocol with CDP automatic disbursement (built for Coinbase hackathon) - **`crypto_tipping`** - Send cryptocurrency tips to tip.md users - **`check_tipping_balance`** - Check your tipping wallet balance - **`withdraw_tipping_funds`** - Withdraw funds from your tipping wallet - **`export_tipping_wallet`** - Export your tipping wallet private key - **`get_user_wallet_types`** - Get supported wallet types for a user - **`ping`** - Test MCP server connectivity ### Hackathon Innovation 🏆 *This MCP server was built for a Coinbase hackathon leveraging CDP tools, showcasing the innovative [TipMD project](https://devfolio.co/projects/tipmd-d033) that transforms any AI agent into a payment-enabled tipping agent using x402 payment collection with CDP automatic disbursement.* ## Cursor Setup 1. **Open Cursor's MCP Configuration:** - Edit or create the file at `~/.cursor/mcp.json` 2. **Add our tip.md service:** ```json { "mcpServers": { "tip.md": { "command": "npx mcp-remote https://mcp.tip.md/mcp" } } } ``` 3. **Enable the tip.md service** - Open Cursor's MCP settings panel and enable the tip.md service. ## Sage App Setup [Sage](https://sageapp.ai) is a native AI client that supports MCP and can be easily connected to tip.md. Here's how to set it up: 1. **Go to Tools** - Open the Sage app and navigate to the Tools section in the settings. 2. **MCP Servers under MCP Configuration** - Find and select the MCP Servers section under MCP configuration. 3. **Click on "Add Server"** - This will open the server configuration dialog. 4. **Add the configuration details** - Enter the following information: - Connection Type: **Streamable HTTP** - Server Name: **tip.md** - Endpoint URL: **https://mcp.tip.md/mcp** 5. **Click "Add" to save the configuration** - The tip.md server should now appear in your list of available MCP servers. 6. **Test in the chat** - Return to chat and ask Sage about tip.md functionality, such as "What tools are available for tip.md?" or "How can I check a user's wallet types?" ## Claude Desktop Setup Since Claude Desktop only supports stdio transport for MCP servers, you need to use [Supergateway](https://github.com/supercorp-ai/supergateway) to bridge our HTTP-stream transport to stdio. ### Prerequisites - **Node.js**: Installed on your system (download from [nodejs.org](https://nodejs.org)) - **Claude Desktop**: Latest version installed - **[Supergateway](https://github.com/supercorp-ai/supergateway)**: Install globally via npm: ``` npm install -g supergateway ``` - **Docker (Optional)**: If you prefer running Supergateway in a container ### Steps to Add the MCP Server to Claude Desktop 1. **Run [Supergateway](https://github.com/supercorp-ai/supergateway) to Bridge HTTP-Stream to Stdio** - [Supergateway](https://github.com/supercorp-ai/supergateway) supports HTTP-stream transport as an input, converting it to stdio for Claude Desktop: ``` npx -y supergateway --httpStream "https://mcp.tip.md/mcp" --outputTransport stdio ``` 2. **Configure Claude Desktop** - Locate or create the Claude Desktop configuration file: - **Windows:** `C:\Users\YourUsername\AppData\Roaming\Claude\claude_desktop_config.json` - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` - Add the [Supergateway](https://github.com/supercorp-ai/supergateway) command to the configuration: ```json { "mcpServers": { "tip-md-mcp": { "command": "npx", "args": [ "-y", "supergateway", "--httpStream", "https://mcp.tip.md/mcp", "--outputTransport", "stdio" ] } } } ``` - Save the file and restart Claude Desktop. 3. **Verify the Setup** - Open Claude Desktop and look for the hammer icon in the bottom right corner of the input box. - Test the server by asking "How can I tip user tipdotmd?". - If the server doesn't appear, check logs: - **macOS**: `tail -n 20 -f ~/Library/Logs/Claude/mcp*.log` - **Windows**: `type "%APPDATA%\Claude\logs\mcp*.log"` ### Notes and Troubleshooting - **HTTP-Stream Transport**: - HTTP-stream is a newer transport replacing SSE in the MCP protocol. Ensure you're using the latest Supergateway: ```bash npm update -g supergateway ``` - **Debugging**: - If the hammer icon doesn't appear, verify Supergateway is running without errors (check terminal output). - Test the server independently using a tool like Postman or a custom MCP client. - **Alternative Clients**: - Consider clients like Cursor, which natively support HTTP-stream transport, avoiding the need for Supergateway. ## Other MCP Clients For clients other than Cursor or Claude Desktop: 1. Find your client's method for configuring MCP servers 2. Configure it to an "http-stream" transport and connect to `https://mcp.tip.md/mcp` 3. If your client supports command-based MCP connections, use: ``` npx -y --package=@modelcontextprotocol/remote mcp-remote https://mcp.tip.md/mcp ``` ## Troubleshooting - **Connection issues?** - Verify you can reach our service with: `curl -I https://mcp.tip.md/mcp` - **Tool not showing?** - Make sure to fully restart your client after configuration. - **Any other issues?** - Reach out to us at [support@tip.md](mailto:support@tip.md) *Our MCP service was built using the excellent [mcp-framework](https://mcp-framework.com/).*# Farcaster Mini App ## Overview The tip.md Farcaster mini app brings crypto tipping directly into your Farcaster experience. Built with the @farcaster/frame-sdk, it provides seamless tipping, developer discovery, and social features within the Farcaster ecosystem. ## Accessing the Mini App 1. **Search for tip.md in Farcaster** - Open Farcaster and search for "tip.md" in the mini app directory - Look for the verified tip.md mini app or visit our profile @tipdotmd 2. **Install the Mini App** - Tap "Add to Farcaster" to not miss our notifications for new features or updates 3. **Automatic Profile Setup** - Your Farcaster profile (username, bio, avatar) is automatically imported - If you have an existing tip.md account linked to your GitHub, it will be connected automatically ## Core Features ### Developer Tipping - **Direct Wallet Access**: Tip developers using Ethereum, Base or Solana directly from your connected wallets - **Quick Amounts**: Pre-set tip amounts for fast transactions - **Custom Messages**: Add personal messages to your tips - **Transaction History**: View your sent and received tips ### Developer Discovery - **GitHub Activity Feed**: See recent development activity from your Farcaster network through personalized GitHub activity feeds - **Trending Developers**: Discover active developers based on recent contributions - **Profile Integration**: View developer profiles with linked GitHub and wallet information ### Social Features - **Dev Stats Sharing**: Create and share developer activity summaries as Farcaster frames - **Tip Celebrations**: Share successful tips with the community - **Developer Networks**: Build connections with other developers in the ecosystem ## Account Linking ### Automatic Profile Creation When you first use the mini app: - Your Farcaster profile data (username, bio, avatar) is automatically imported - The system checks for existing tip.md accounts linked to your GitHub username - If found, your Farcaster account is linked to your existing profile - If not found, a new profile is created with your Farcaster data ### Manual GitHub Linking - Link your existing GitHub account for enhanced developer discovery - This enables the mini app to show your GitHub activity and contributions - Helps other users find and tip you based on your development work ## Wallet Integration ### Supported Wallets - **Ethereum**: Direct access via wagmi integration with @farcaster/frame-wagmi-connector - **Base**: EVM compatible wallet support with lower fees than Ethereum mainnet - **Solana**: Experimental Solana provider support for SOL and SPL token transfers - **Multi-chain**: Switch between different blockchains within the app ### Transaction Flow 1. Select a developer to tip 2. Choose your preferred cryptocurrency and amount 3. Confirm the transaction with your connected wallet 4. Share your tip (optional) with the Farcaster community ## Dev Stats Feature ### Creating Dev Stats - The mini app analyzes GitHub activity from your Farcaster network - Generates visual summaries of developer contributions and activity - Creates shareable frames with developer highlights ### Sharing Dev Stats - Export dev stats as Farcaster frames - Share directly to your feed with pre-composed casts - Celebrate and promote developer activity in your network ## Getting Started 1. **Install the Mini App** - Find "tip.md" in Farcaster's mini app directory - Install and grant wallet permissions 2. **Set Up Your Profile** - Your Farcaster profile is automatically imported - Link your GitHub account (optional but recommended) - Add additional wallet addresses if needed 3. **Start Tipping** - Browse the developer feed - Find developers whose work you want to support - Send tips directly from the mini app 4. **Engage Socially** - Share your tips with the community - Create and share dev stats summaries - Discover new developers through the trending feeds ## Technical Requirements - **Farcaster App**: Latest version of Farcaster - **Crypto Wallets**: Ethereum, Base or Solana wallets connected to Farcaster - **Permissions**: Wallet access and compose cast permissions ## Troubleshooting ### Mini App Not Loading - Ensure you have the latest version of Farcaster - Check your internet connection - Try closing and reopening the mini app ### Wallet Connection Issues - Verify your wallets are properly connected to Farcaster - Check that you've granted necessary permissions - Try disconnecting and reconnecting your wallet ### Transaction Failures - Ensure sufficient balance for transactions and gas fees - Check network connectivity - Verify the recipient's wallet address is valid ## Privacy and Security - **No Private Keys**: The mini app never accesses your private keys - **Direct Transactions**: All tips go directly to recipient wallets - **Farcaster Authentication**: Uses secure Farcaster authentication flow - **Minimal Data**: Only necessary profile and activity data is processed For additional support with the Farcaster mini app, contact support@tip.md or reach out on Farcaster @tipdotmd.# Frequently Asked Questions ## General Questions ### What is Tip.md? Tip.md is a platform that allows developers to receive cryptocurrency tips directly to their wallets via a simple button that can be embedded in GitHub READMEs, websites, or any markdown content. ### How much does Tip.md cost to use? Tip.md charges a flat 4% fee on all tips received. There are no subscription fees or hidden charges. For Ethereum and Base tips using Splits.org integration, additional fees from Splits.org may apply. ### Which cryptocurrencies are supported? Currently, Tip.md supports: - **Ethereum**: ETH and USDC - **Base**: ETH and USDC - **Solana**: SOL and USDC - **Bitcoin**: via Lightning Network We're continuously evaluating additional blockchains and tokens to add in the future. ## Account and Setup ### Do I need a cryptocurrency wallet to use Tip.md? Yes, you need at least one cryptocurrency wallet address to receive tips. You can add addresses for: - **Ethereum**: supports ETH and USDC - **Base**: supports ETH and USDC - **Solana**: supports SOL and USDC - **Bitcoin Lightning Network**: supports BTC ### Can I use multiple wallet addresses? Yes, you can add multiple wallet addresses for each supported blockchain. Tips will be sent to the address you've designated for that particular cryptocurrency. ### How do I change my wallet address? Go to "Wallet Settings" in your dashboard, find the wallet you wish to update, click "Edit," make your changes, and save. All future tips will go to the updated address. ## Button and Integration ### Can I customize how my tip button looks? Yes, you can customize the size, text, and default currency displayed on your button using parameters in the button URL. ### Where can I add my Tip.md button? You can add your button to GitHub READMEs, personal websites, blogs, or any platform that supports markdown or HTML embedding. ### Does my audience need a Tip.md account to tip me? No, tippers don't need to create an account. They simply need a cryptocurrency wallet with the supported cryptocurrencies to send tips. ## Transactions and Fees ### How quickly will I receive tips? Tips are sent directly to your wallet, so the speed depends on the blockchain used: - **Ethereum** (ETH/USDC): typically take a few minutes - **Base** (ETH/USDC): faster with lower fees than Ethereum - **Solana** (SOL/USDC): nearly instant transactions - **Bitcoin Lightning**: immediate payments ### Who pays the transaction fees? The person sending the tip (tipper) pays any blockchain transaction fees (gas fees for Ethereum and Base, etc.). ### Is there a minimum tip amount? There's no platform-enforced minimum, but due to blockchain transaction fees, very small tips may not be practical on certain networks (particularly Ethereum during high gas price periods, though Base offers significantly lower fees). ## Security and Privacy ### Does Tip.md hold my funds at any point? No, Tip.md never holds your cryptocurrency. All transactions happen directly between the tipper's wallet and your wallet. ### Is my wallet address visible to others? Your wallet address is visible to anyone who sends you a tip, as it's necessary for the transaction. However, it's not publicly displayed on your profile unless you choose to share it. ### How secure is Tip.md? Tip.md uses client-side transactions for maximum security. We never handle or store private keys. All sensitive data is encrypted, and we follow industry best practices for web security. ## Technical Support ### What should I do if a tip doesn't arrive? First, check the transaction on a blockchain explorer using the transaction ID. If the transaction was confirmed but you don't see the funds, verify your wallet address in your settings. For unresolved issues, contact support@tip.md. ### Can I use Tip.md with hardware wallets? Yes, you can add any valid wallet address to your Tip.md account, including addresses from hardware wallets like Ledger or Trezor. ### Where can I get additional help? For technical support, email support@tip.md. For general questions, check our other documentation pages: - [Getting Started](getting-started.md) - [Button Setup](button-setup.md) - [Receiving Tips](receiving-tips.md) - [Wallet Management](wallet-management.md) - [MCP Server](mcp-server.md)