@divvi/mcp-server
Advanced tools
A Model Context Protocol (MCP) server that enables AI assistants to automatically integrate the @divvi/referral-sdk into JavaScript/TypeScript blockchain applications.
A Model Context Protocol (MCP) server that provides AI assistants with tools for working with the Divvi ecosystem. Currently focuses on automatic integration of the @divvi/referral-sdk into JavaScript/TypeScript blockchain applications, with more Divvi-related functionality planned for future releases.
Integrating referral tracking into blockchain applications typically requires understanding SDK documentation, modifying transaction flows, and maintaining integration code as protocols evolve. This MCP server eliminates that complexity by turning any AI assistant into a Divvi integration expert that can automatically implement referral tracking following current best practices.
Compatible with any JavaScript/TypeScript blockchain application, including:
The server currently provides an MCP tool (integrate_divvi_referral_sdk) that:
⚠️ Prerequisites: Before using this tool, you need to install and configure the MCP server. See the Installation section below.
The easiest way to use this is to simply ask your AI assistant:
"Integrate this dapp with Divvi"
Your AI assistant will guide you through providing the necessary configuration (your Divvi dapp address and campaign addresses) and handle the entire integration process.
For more specific control, you can provide the exact parameters:
"Integrate my dapp with Divvi using consumer address 0x1234..."
The AI assistant will:
To complete the integration, you'll need:
// The AI assistant will call this internally
integrate_divvi_referral_sdk({
consumerAddress: '0x1234567890123456789012345678901234567890',
})
Technical Note: This integration is implemented as an MCP "tool" rather than a "prompt" type. While the MCP specification includes a prompt type that would be more semantically appropriate for this use case, we chose the tool implementation for broader compatibility, as Cursor doesn't currently support MCP prompts.
The easiest way to use the Divvi MCP server is via npm:
Add to your claude_desktop_config.json:
{
"mcpServers": {
"divvi-mcp": {
"command": "npx",
"args": ["-y", "@divvi/mcp-server"],
"env": {}
}
}
}
Cursor supports MCP servers through its settings. Add the server configuration:
divvi-mcpnpx["-y", "@divvi/mcp-server"]Alternatively, if Cursor uses a configuration file, add:
{
"mcpServers": {
"divvi-mcp": {
"command": "npx",
"args": ["-y", "@divvi/mcp-server"]
}
}
}
Configure according to your MCP client's documentation, using:
npx["-y", "@divvi/mcp-server"]For development or if you prefer building from source:
Clone the repository:
git clone https://github.com/divvi-xyz/divvi-mcp.git
cd divvi-mcp
Install dependencies:
yarn install
Build the server:
yarn build
Configure your AI assistant to point to the local build:
Use node as the command and ["/path/to/divvi-mcp/dist/index.js"] as the args in your MCP client configuration.
The tool instructs AI agents to read the official SDK documentation from:
https://raw.githubusercontent.com/divvi-xyz/divvi-referral-sdk/refs/heads/main/README.md
This ensures the integration always follows the latest patterns and examples.
AI agents analyze the target project to understand:
Following the official documentation, AI agents implement:
The integration ensures:
# Start in development mode
yarn dev
# Run tests
yarn test
# Type checking
yarn typecheck
# Linting
yarn lint
# Format code
yarn format
src/
├── index.ts # Main MCP server implementation
├── index.test.ts # Unit tests
└── ...
scripts/ # Build and utility scripts
dist/ # Compiled output
git checkout -b feature/my-featureyarn testintegrate_divvi_referral_sdkProvides instructions for integrating the @divvi/referral-sdk into a project.
| Parameter | Type | Required | Description |
|---|---|---|---|
consumerAddress | string | Yes | Your Divvi dapp wallet address (builder registration) |
Comprehensive integration instructions that guide AI agents through:
Additional tools for the Divvi ecosystem are planned for future releases. These may include:
Stay tuned for updates as we expand the server's capabilities!
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Built with ❤️ for the Divvi ecosystem
FAQs
A Model Context Protocol (MCP) server that enables AI assistants to automatically integrate the @divvi/referral-sdk into JavaScript/TypeScript blockchain applications.
The npm package @divvi/mcp-server receives a total of 190 weekly downloads. As such, @divvi/mcp-server popularity was classified as not popular.
We found that @divvi/mcp-server demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket’s new Tier 1 Reachability filters out up to 80% of irrelevant CVEs, so security teams can focus on the vulnerabilities that matter.
Research
/Security News
Ongoing npm supply chain attack spreads to DuckDB: multiple packages compromised with the same wallet-drainer malware.
Security News
The MCP Steering Committee has launched the official MCP Registry in preview, a central hub for discovering and publishing MCP servers.