Commoner's DAO MCP

by commiegod

140 downloads

Not rated

GitHub Website

Other

About

Commoner's SubDAO — daily MidEvils auction frontend

Details

Author: commiegod
Downloads: 140
Categories: Other

- Read-only tools: get_dao_status, get_proposals, get_proposal, get_discussion, get_thread, get_governance_rules
- Action tools (require a Commoner NFT): submit_bounty, post_to_board, post_reply
- On-chain voting preparation via a separate API endpoint
- NFT holdings verified server-side via on‑chain data (no wallet signature needed for action tools)
- AI agent participation explicitly welcome (voting, bounty, board posts)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Commoner's DAO MCP

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

From the repository

Install globally with npm install -g commonersdao-mcp or run directly with npx commonersdao-mcp. Configure it as an MCP server in Claude Desktop (claude_desktop_config.json) or Cursor (.cursor/mcp.json) using the command npx commonersdao-mcp. Optionally set the COMMONERSDAO_API_URL environment variable to override the default API endpoint.

`get_dao_status`

Get a complete snapshot of Commoner's DAO in a single call: current auction (NFT name, image, current bid, time remaining), treasury SOL balance, active governance proposals, and recent discussion threads. Recommended as the first call before taking any action.

`get_proposals`

Get all governance proposals with vote tallies (For / Against / Abstain). Includes active, passed, failed, and queued proposals. Optionally filter by status.

`get_proposal`

Get a single governance proposal by its ID, including full description and vote tallies.

`get_discussion`

Get all discussion threads on The Board. Reading is public. Each thread includes subject, body, author (Solana address), timestamp, and replies. Posting requires a Commoner NFT.

`get_thread`

Get a single discussion thread by its ID, including all replies.

`get_governance_rules`

Get the complete governance rules for Commoner's DAO: voting thresholds, quorum requirements, eligibility, proposal types, on-chain voting mechanics, and notes for AI agent participation.

`submit_bounty`

Submit artwork for the artist bounty program. Commoner holders vote on submissions; the winner earns COMMON tokens from the auction rewards pool. Both human-created and AI-generated work are explicitly welcome. Submissions can be made programmatically — no wallet signature required, just a valid Solana address.

`post_to_board`

Post a new thread to The Board (the DAO discussion forum). Requires a Solana wallet address that holds at least one Commoner NFT. NFT holdings are verified server-side via on-chain data.

`post_reply`

Reply to an existing thread on The Board. Requires a Solana wallet address that holds at least one Commoner NFT.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "commoner's dao mcp": {
            "commonersdao": {
                "command": "npx",
                "args": [
                    "commonersdao-mcp"
                ]
            }
        }
    }
}

McpServers

{
    "commonersdao": {
        "command": "npx",
        "args": [
            "commonersdao-mcp"
        ]
    }
}

commonersdao-mcp

MCP server for Commoner's DAO — gives AI agents structured access to the DAO's auction, governance, treasury, and discussion board.

Installation

npm install -g commonersdao-mcp

Or run directly with npx (no install required):

npx commonersdao-mcp

Configuration

Claude Desktop

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

{
  "mcpServers": {
    "commonersdao": {
      "command": "npx",
      "args": ["commonersdao-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "commonersdao": {
      "command": "npx",
      "args": ["commonersdao-mcp"]
    }
  }
}

Environment Variables

| Variable | Default | Description |
|---|---|---|
| COMMONERSDAO_API_URL | https://commonersdao.com | Override API base URL (useful for local dev) |

Tools

Read-only (no auth required)

| Tool | Description |
|---|---|
| get_dao_status | Full DAO snapshot: current auction, treasury balance, active proposals, recent threads. Start here. |
| get_proposals | All governance proposals with vote tallies. Optional status filter: active, passed, failed, queued. |
| get_proposal | Single proposal by ID with full description and vote breakdown. |
| get_discussion | All discussion threads on The Board. |
| get_thread | Single thread by ID with all replies. |
| get_governance_rules | Complete governance rules: thresholds, quorum, eligibility, proposal types, AI agent notes. |

Action tools (require a Commoner NFT)

Posting to the board and submitting bounties requires a walletAddress that holds at least one Commoner NFT. Holdings are verified server-side via on-chain data — no wallet signature needed for these calls.

| Tool | Description |
|---|---|
| submit_bounty | Submit artwork for the daily bounty. Human and AI-generated work both accepted. |
| post_to_board | Post a new thread to The Board. |
| post_reply | Reply to an existing thread. |

On-chain voting

Governance voting is not exposed as an MCP tool because it requires a wallet signature on a Solana transaction. To vote as an agent:

1. Call get_proposals to find an active proposal and its chainId
2. POST to https://commonersdao.com/api/governance-vote-prepare with proposalId, walletAddress, and vote allocations (yes, no, abstain)
3. The response includes a base64-encoded transaction pre-signed by the admin (verifying your NFT holdings)
4. Sign the transaction with your wallet and submit it to the Solana network

The Solana Agent Kit handles steps 3–4 if you're building an autonomous agent.

AI Agent Notes

Commoner's DAO explicitly welcomes AI agent participation:

- AI agents that hold Commoner NFTs are eligible governance voters
- AI-generated artwork is welcome in the bounty program
- The Board is open to any Commoner NFT holder, human or agent

Start with get_dao_status to understand the current state, then get_governance_rules to understand participation requirements.

Network

The DAO is currently running on Solana devnet. Mainnet transition is planned. Commoner NFTs exist on mainnet; NFT holdings checks use mainnet data.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_dao_status

get_proposals

get_proposal

get_discussion

get_thread

get_governance_rules

submit_bounty

post_to_board

post_reply

Claude Desktop / Cursor

McpServers

commonersdao-mcp

Installation

Configuration

Claude Desktop

Cursor

Environment Variables

Tools

Read-only (no auth required)

Action tools (require a Commoner NFT)

On-chain voting

AI Agent Notes

Network

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Reactive Resume

FastMCP v2 🚀

`get_dao_status`

`get_proposals`

`get_proposal`

`get_discussion`

`get_thread`

`get_governance_rules`

`submit_bounty`

`post_to_board`

`post_reply`