The DeSo MCP Server transforms Cursor IDE's AI assistant into a comprehensive DeSo development expert, offering tools for:
- Explore DeSo APIs: Access detailed documentation and code examples for all DeSo API categories (social, financial, NFT, identity)
- Generate Production Code: Create ready-to-use code snippets for DeSo operations in JavaScript, TypeScript, React, or cURL
- Guide deso-js SDK Usage: Learn setup, authentication, transactions, and best practices
- Understand DeSo Architecture: Get explanations of systems, transaction flows, and integration patterns
- Search DeSo Repositories: Find documentation and resources across repositories
- Debug Common Issues: Solve integration problems with real solutions
- Implement Best Practices: Learn proven patterns for messaging flows, error handling, and state management
- Access UI Components: Explore 40+ professional React components for building DeSo applications
- Query Blockchain Data: Convert natural language to optimized GraphQL queries
- Develop Complete Apps: Build scalable, production-ready DeSo applications with framework-specific examples
Generates curl commands for interacting with DeSo blockchain APIs, allowing for testing and debugging of DeSo operations directly from the command line.
Provides DeSo GraphQL schema and integration guidance for querying the DeSo blockchain through GraphQL.
Provides comprehensive code generation for DeSo blockchain operations using JavaScript, with detailed guidance on implementing DeSo features.
Provides Next.js-specific implementation patterns for DeSo blockchain integration, including server-side integration and API routes.
Supports Node.js implementation patterns for server-side DeSo blockchain integration with detailed SDK setup guidance.
Offers React component patterns and implementation guidance for DeSo blockchain integration, including authentication flows and state management.
Includes modern UI examples with Tailwind CSS for DeSo applications, demonstrated in the complete messaging application example.
Generates TypeScript code examples for DeSo blockchain integration with type safety, supporting professional-grade DeSo application development.
DeSo MCP Server for Cursor IDE v3.0
A comprehensive Model Context Protocol (MCP) server that provides complete DeSo blockchain API coverage for Cursor IDE. This server transforms Cursor's AI assistant into a DeSo development expert with extensive knowledge about all DeSo APIs, the deso-js SDK, DeSo Identity authentication, backend implementation details, production-ready code generation, and comprehensive debugging solutions.
🔥 What's New in v3.0
- 🛠️ Comprehensive Debugging Guide: Real solutions for all major DeSo integration issues
- 🏗️ Implementation Patterns: Best practices learned from building production DeSo apps
- 🎨 DeSo UI Component Library: Complete frontend component system with 40+ ready-to-use React components
- 📦 Component Installation: Automated shadcn CLI integration with installation commands and examples
- 🔍 GraphQL Query Builder: Natural language to GraphQL conversion with complete DeSo blockchain schema coverage
- 📊 Blockchain Data Access: Query user profiles, posts, followers, NFTs, and more with ready-to-use GraphQL queries
- 📱 Complete Example App: Full DeSo messaging application with Next.js, TypeScript, and Tailwind
- 🐛 Real Debugging Experience: Solutions based on actual debugging sessions and common pitfalls
What's New in v2.2-2.3
- Complete DeSo Identity Integration: Full authentication system coverage
- 9 Identity API Endpoints: iframe & window APIs for login, signing, encryption
- Advanced Authentication Guide: Access levels, derived keys, message encryption
- Complete Data API Coverage: All endpoint categories from DeSo backend documentation
- 40+ Data Endpoints: Users, Posts, NFTs, Messages, Notifications, Access Groups, and more
🚀 What This Does
This MCP server transforms Cursor's AI assistant into a DeSo development expert by providing:
- Complete DeSo API Knowledge: All endpoints from the backend with handler details
- deso-js SDK Expertise: Full SDK documentation and usage patterns
- Code Generation: Production-ready examples in JavaScript, TypeScript, React, and cURL
- Architecture Guidance: Deep understanding of DeSo's transaction flows and systems
- Backend Integration: Direct mapping to
routes/transaction.go
and other backend files - 🎨 UI Component Library: 40+ professional React components for DeSo applications
- 📦 Component Installation: Automated shadcn CLI commands and dependency management
- 🔍 GraphQL Query Builder: Convert natural language questions to optimized GraphQL queries
- 📊 Blockchain Data Explorer: Complete access to DeSo's GraphQL API with 15,000+ schema lines
- 🛠️ Debugging Solutions: Real fixes for common DeSo integration problems
- 🏗️ Best Practices: Implementation patterns from production DeSo applications
📋 Available Tools Overview
Core Development Tools
- 🔍
deso_api_explorer
- Complete DeSo API reference with code examples - 📚
deso_js_guide
- Comprehensive deso-js SDK documentation and setup - ⚡
generate_deso_code
- Production-ready code generation for any DeSo operation - 🏛️
explain_deso_architecture
- Deep architecture explanations and integration patterns
Knowledge Base Tools
- 🔎
repository_search
- Search across all DeSo documentation and repositories - 📖
read_repository_document
- Read specific documentation files from DeSo repos
UI Development Tools (NEW in v3.0)
- 🎨
deso_ui_components
- Complete DeSo UI component library with installation and usage examples
Data Query Tools (NEW in v3.0)
- 🔍
deso_graphql_helper
- GraphQL query builder and blockchain data explorer
Advanced Debugging Tools (NEW in v3.0)
- 🛠️
deso_debugging_guide
- Comprehensive debugging for common DeSo issues - 🏗️
deso_implementation_patterns
- Best practices from real DeSo application development
🛠️ Complete Tool Reference
1. deso_api_explorer
- API Explorer
Comprehensive DeSo API explorer with backend implementation details and deso-js SDK integration.
Parameters:
category
(required): API category to explore- Options:
"social"
,"financial"
,"nft"
,"dao"
,"tokens"
,"access"
,"associations"
,"derived-keys"
,"messages"
,"data"
,"notifications"
,"media"
,"admin"
,"blockchain"
,"identity"
,"all"
- Options:
endpoint
(optional): Specific endpoint nameincludeCode
(optional): Include code examples
Example Usage:
2. deso_js_guide
- SDK Guide
Complete guide to using the deso-js SDK with setup, authentication, and transactions.
Parameters:
topic
(required): Topic to get guidance on- Options:
"setup"
,"identity"
,"authentication"
,"transactions"
,"data"
,"permissions"
,"examples"
,"troubleshooting"
- Options:
framework
(optional): Framework context- Options:
"vanilla"
,"react"
,"nextjs"
,"node"
- Options:
Example Usage:
3. generate_deso_code
- Code Generator
Generate comprehensive code examples for DeSo operations using deso-js SDK.
Parameters:
operation
(required): DeSo operation (e.g., 'follow', 'post', 'buy-creator-coin', 'send-diamonds')language
(required): Programming language/framework- Options:
"javascript"
,"typescript"
,"react"
,"curl"
- Options:
includeAuth
(optional): Include authentication setupfullExample
(optional): Generate complete working example
Example Usage:
4. explain_deso_architecture
- Architecture Guide
Explain DeSo architecture, flows, and integration patterns.
Parameters:
topic
(required): Architecture topic to explainincludeCode
(optional): Include code examples
Example Usage:
5. repository_search
- Repository Search
Search for documents in the DeSo repository.
Parameters:
query
(required): Search query
Example Usage:
6. read_repository_document
- Document Reader
Read a specific document from the DeSo repository.
Parameters:
path
(required): Relative path to the document (e.g., 'docs/deso-tutorial-build-apps.md')repository
(optional): Repository name- Options:
"docs"
,"core"
,"identity"
,"frontend"
,"backend"
,"deso-js"
- Options:
Example Usage:
7. deso_ui_components
- UI Component Library (NEW in v3.0)
Comprehensive DeSo UI component library explorer with installation commands, usage examples, and component relationships.
Parameters:
action
(required): Action to perform with the UI component library- Options:
"explore"
,"install"
,"usage"
,"dependencies"
,"examples"
,"layouts"
,"categories"
,"search"
- Options:
component
(optional): Specific component name (e.g., 'post-card', 'editor', 'profile-picture')category
(optional): Component category to explore- Options:
"social"
,"user"
,"messaging"
,"media"
,"interactive"
,"navigation"
,"layout"
,"all"
- Options:
framework
(optional): Target framework for examples- Options:
"react"
,"nextjs"
,"vanilla"
- Options:
query
(optional): Search query for components
Example Usage:
8. deso_graphql_helper
- GraphQL Query Builder (NEW in v3.0)
GraphQL query builder and schema explorer for DeSo blockchain data. Converts natural language questions into optimized GraphQL queries and provides complete blockchain data access.
Parameters:
action
(required): Action to perform with GraphQL- Options:
"query"
,"schema"
,"examples"
,"build"
,"explain"
- Options:
queryType
(optional): Type of query to build or explain- Options:
"user"
,"posts"
,"followers"
,"following"
,"likes"
,"diamonds"
,"messages"
,"nfts"
,"custom"
- Options:
username
(optional): Username to query for (e.g., 'nader')publicKey
(optional): Public key to query forquestion
(optional): Natural language question to convert to GraphQLcustomQuery
(optional): Custom GraphQL query to explain or validate
Example Usage:
9. deso_debugging_guide
- Debugging Guide (NEW in v3.0)
Comprehensive debugging guide for common DeSo integration issues with real solutions.
Parameters:
issue
(required): Specific issue to debug or 'all' for complete guide- Options:
"message-decryption"
,"access-groups"
,"infinite-loops"
,"api-responses"
,"authentication"
,"react-errors"
,"all"
- Options:
includeCode
(optional): Include code examples and fixes
Example Usage:
10. deso_implementation_patterns
- Implementation Patterns (NEW in v3.0)
Best practices and implementation patterns learned from real DeSo application development.
Parameters:
pattern
(required): Implementation pattern to explore- Options:
"messaging-flow"
,"error-handling"
,"state-management"
,"api-integration"
,"user-switching"
,"real-time-updates"
,"all"
- Options:
framework
(optional): Framework context- Options:
"react"
,"vanilla"
,"nextjs"
- Options:
Example Usage:
🎨 DeSo UI Component Library Integration
The MCP server now includes complete integration with the official DeSo UI component library, providing:
Component Categories:
- 🏃 Social - Post cards, feeds, engagement metrics, reactions (10 components)
- 👤 User - Profile cards, avatars, authentication, user search (8 components)
- 💬 Messaging - Chat interfaces, conversation management, message bubbles (5 components)
- 🎬 Media - Image galleries, video players, media cards, video reels (4 components)
- ⚡ Interactive - Rich text editor, search bars, action menus, dialogs (6 components)
- 🧭 Navigation - Sidebars, menus, logos (2 components)
- 🔧 Utility - Timestamps, copy buttons, verification badges (3 components)
Key Features:
- 🎯 Instant Installation: Generate exact
shadcn
CLI commands - 📚 Usage Examples: React/TypeScript code examples with DeSo SDK integration
- 🔗 Dependency Management: Automatic dependency resolution and installation order
- 🏗️ Complete Layouts: Ready-to-use patterns for Twitter-like apps, messaging, profiles
- 🔍 Smart Search: Find components by name, description, or functionality
- 📱 Responsive Design: Mobile-first components with Tailwind CSS
Example Component Usage:
🔍 DeSo GraphQL Query Builder Integration
The MCP server now includes complete GraphQL integration with DeSo's blockchain data, providing:
Natural Language to GraphQL:
Convert plain English questions into optimized GraphQL queries:
Complete Schema Coverage:
- 15,574 lines of GraphQL schema fully mapped
- User profiles with follower/following counts, creator coins
- Posts with engagement metrics, timestamps, media
- Social interactions - likes, diamonds, comments, reposts
- NFT marketplace data - bids, sales, royalties
- Messaging - DMs and group conversations
- Financial data - creator coin prices, transactions
Smart Query Optimization:
- Case-insensitive lookups for usernames
- Efficient pagination with proper
first
parameters - Relationship traversal through nested GraphQL fields
- Count optimization using
totalCount
without fetching all records - Proper sorting with
orderBy: [TIMESTAMP_DESC]
for recent content
Ready-to-Use Query Templates:
Supported Data Types:
- 👤 Users: Profiles, followers, following, creator coins
- 📝 Posts: Content, engagement, timestamps, media
- 💎 Diamonds: Sent/received with levels and recipients
- ❤️ Likes: User interactions with posts
- 🖼️ NFTs: Marketplace data, bids, ownership
- 💬 Messages: DMs and group conversations
- 💰 Financial: Creator coin prices, transactions
🎯 Real-World Example: DeSo Messaging App
This repository includes a complete DeSo messaging application built with the MCP server guidance:
Built Application Features:
- ✅ Complete DeSo Identity authentication
- ✅ Real-time user search and discovery
- ✅ Actual blockchain message sending via
sendDMMessage
- ✅ Professional React components with TypeScript
- ✅ Real-time message polling and status updates
- ✅ Comprehensive error handling and debugging features
- ✅ Modern UI with Tailwind CSS and responsive design
Technical Stack:
- Frontend: Next.js 14, React, TypeScript, Tailwind CSS
- DeSo Integration: deso-protocol SDK v3.4.1
- Authentication: DeSo Identity with proper permission management
- State Management: Custom React hooks with proper error handling
Example App Structure:
🛠 Installation & Setup
Prerequisites
- Node.js (v18+ recommended)
- Cursor IDE
- Git (for cloning repositories)
1. Clone and Setup
2. Configure Cursor IDE
Create or update your Cursor MCP configuration file:
File: .cursor/mcp.json
Important: Replace /absolute/path/to/your/deso-mcp
with your actual project path.
💡 Quick tip: Run pwd
in your project directory to get the absolute path:
3. Enable in Cursor Settings
- Open Cursor Settings (
⌘ + ,
on Mac,Ctrl + ,
on Windows/Linux) - Navigate to Features → MCP
- You should see "deso-mcp" listed
- Ensure it shows as "Connected" ✅
4. Test the Integration
- Start a new chat in Cursor (
⌘ + L
orCtrl + L
) - Test with this prompt:
- You should see the AI use your MCP tools and provide comprehensive DeSo-specific guidance!
🎯 Usage Examples
Once configured, you can ask Cursor's AI assistant questions like:
API Exploration
- "Show me all the identity endpoints for DeSo authentication"
- "What are the iframe vs window APIs in DeSo Identity?"
- "Show me all the data endpoints available in DeSo"
- "What notification APIs can I use to get user notifications?"
- "How do I fetch DM messages using the messages API?"
Code Generation
- "Generate a React authentication component with DeSo Identity"
- "Show me how to encrypt and decrypt messages using deso-js"
- "Create a derived key manager for mobile apps"
- "Generate a React component for creating and minting NFTs"
- "Create a complete DeSo messaging interface with TypeScript"
UI Component Development
- "Show me all available DeSo UI components for social media"
- "Install the post-card component with usage examples"
- "Generate a complete Twitter-like layout using DeSo UI components"
- "Show me messaging components for building a chat interface"
- "Find components for user profiles and authentication"
- "Create a media gallery layout with DeSo UI components"
GraphQL Data Queries
- "Convert this to GraphQL: How many followers does nader have?"
- "Generate a query to get user posts with engagement metrics"
- "Show me the GraphQL schema for DeSo user accounts"
- "Build a query to find when a user last posted"
- "Get GraphQL examples for diamonds and NFT data"
- "Explain this GraphQL query and optimize it"
Debugging & Troubleshooting
- "Help me debug DeSo message decryption that's returning undefined"
- "Fix infinite loops in my React DeSo authentication component"
- "Why am I getting 400 errors when sending DeSo messages?"
- "Debug access group empty string vs undefined issues"
- "Show me the correct way to handle DeSo API responses"
Implementation Patterns
- "Show me best practices for DeSo messaging flow architecture"
- "What's the recommended error handling pattern for DeSo apps?"
- "How should I implement user switching in a DeSo application?"
- "Show me real-time polling patterns for DeSo messaging"
Setup & Configuration
- "How do I set up the deso-js SDK in a React app?"
- "What permissions do I need for posting transactions?"
- "Show me how to configure identity management"
- "What are the different access levels in DeSo Identity?"
🔧 Development Commands
📁 Project Structure
🐛 Troubleshooting
MCP Server Not Connecting
- Check the path in
.cursor/mcp.json
is absolute and correct - Update to use
deso-mcp.js
(latest with UI + GraphQL) instead ofdeso-mcp-final.js
ormcp-server.js
- Restart Cursor completely
- Check server runs manually:
Tools Not Available in Chat
- Start a new chat session in Cursor (
⌘ + L
) - Explicitly mention MCP tools in your first message
- Check MCP status in Cursor Settings → Features → MCP
Dependencies Issues
Common DeSo Integration Issues
Use the debugging guide tool for specific issues:
The server includes comprehensive debugging solutions for:
- Message decryption problems (DecryptedMessage vs MessageText)
- Access group handling (empty strings vs undefined)
- React infinite loops (useCallback dependencies)
- API response structure issues
- Authentication flow problems
- User switching and state management
🚀 Advanced Features
Real Debugging Experience
The v3.0 server includes solutions for actual problems encountered while building DeSo applications:
- Message Decryption Fix: Proper handling of
DecryptedMessage
vsMessageText
properties - Access Groups Solution: Correct empty string vs undefined handling
- React Integration: Solutions for key warnings, state management, and error boundaries
- API Response Handling: Proper response structure handling per endpoint
- Authentication Flows: Complete identity event handling and user switching
Production Patterns
Learn from real implementation patterns:
- Complete messaging flow with encryption and access groups
- Comprehensive error handling with retry logic
- Professional state management patterns
- Real-time polling and optimistic updates
- User experience best practices
Framework-Specific Examples
The server can generate examples for different frameworks:
- Vanilla JavaScript: Basic SDK usage
- React: Component patterns with hooks and TypeScript
- Next.js: Server-side integration and API routes
- React Native: Mobile-specific configuration
📚 Related Resources
🤝 Contributing
- Fork the repository
- Create a feature branch
- Add new MCP tools or enhance existing ones
- Update this README with new features
- Submit a pull request
✅ Quick Verification Checklist
After setup, verify everything is working:
🎉 What You Can Do Now
With this MCP server, your Cursor AI assistant can:
✅ Explore any DeSo API with complete documentation and code examples
✅ Generate production-ready code for any DeSo operation in multiple languages
✅ Build beautiful UIs with 40+ professional React components from DeSo UI library
✅ Install components instantly with automated shadcn CLI integration
✅ Query blockchain data with natural language to GraphQL conversion
✅ Access complete DeSo data through optimized GraphQL queries (15,574 schema lines)
✅ Debug real DeSo integration problems with tested solutions
✅ Implement best practices learned from production DeSo applications
✅ Understand DeSo architecture with deep technical explanations
✅ Search and read all DeSo documentation and repositories
✅ Create complete applications following proven patterns
✅ Handle authentication flows with proper identity management
Start a new chat in Cursor and experience the power of AI-assisted DeSo development! ⚡
🚀 Ready to build amazing DeSo applications with AI assistance!
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A comprehensive Model Context Protocol server that transforms Cursor's AI assistant into a DeSo blockchain development expert, providing complete API coverage, debugging solutions, and code generation for DeSo applications.
- 🔥 What's New in v3.0
- What's New in v2.2-2.3
- 🚀 What This Does
- 📋 Available Tools Overview
- 🛠️ Complete Tool Reference
- deso_api_explorer - API Explorer
- deso_js_guide - SDK Guide
- generate_deso_code - Code Generator
- explain_deso_architecture - Architecture Guide
- repository_search - Repository Search
- read_repository_document - Document Reader
- deso_ui_components - UI Component Library (NEW in v3.0)
- deso_graphql_helper - GraphQL Query Builder (NEW in v3.0)
- deso_debugging_guide - Debugging Guide (NEW in v3.0)
- deso_implementation_patterns - Implementation Patterns (NEW in v3.0)
- 🎨 DeSo UI Component Library Integration
- 🔍 DeSo GraphQL Query Builder Integration
- 🎯 Real-World Example: DeSo Messaging App
- 🛠 Installation & Setup
- 🎯 Usage Examples
- 🔧 Development Commands
- 📁 Project Structure
- 🐛 Troubleshooting
- 🚀 Advanced Features
- 📚 Related Resources
- 🤝 Contributing
- ✅ Quick Verification Checklist
- 🎉 What You Can Do Now
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.Last updated -7051Python
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.Last updated -10Python
- AsecurityFlicenseAqualityA starter template for building Model Context Protocol servers that can be integrated with Cursor or Claude Desktop, allowing developers to create custom tools and extensions for AI assistants.Last updated -169TypeScript
- -securityFlicense-qualityA Model Context Protocol server that enables Cursor AI assistants to interact with Todoist tasks directly from the coding environment, supporting advanced task filtering and rich formatting.Last updated -29Python