Commonersdao Mcp

io.github.commiegodPublished by GitHub account commiegodv1.0.1Updated Oct 24, 2026

AI agent access to Commoner's DAO — auction, governance, treasury, and discussion board on Solana.

VerifiedSTDIODesktop onlyFinanceKnowledge & MemoryCommunication & Collaboration

Overview

AI-generated overview

Gives an AI assistant read access to a Solana DAO's auction, governance, treasury, and discussion board, plus NFT-gated posting tools.

What you can do
Connects an assistant to Commoner's DAO through a local npm server. Read-only tools return a full DAO snapshot, governance proposals with vote tallies, individual proposals, discussion threads and replies, and the governance rules. Action tools let a wallet address that holds a Commoner NFT submit bounty artwork, start board threads, and reply to threads. Voting itself is not an MCP tool; the README describes a separate HTTP prepare endpoint and wallet signing flow.
When to use it
Useful when you want an assistant to summarize or monitor this DAO's proposals, treasury, auction, and board discussions, or to draft and post content as an NFT-holding participant. It is specific to one DAO, so it is not a general Solana or governance tool.
Requirements
Node.js with npm or npx; runs locally over stdio and is configured in a desktop client such as Claude Desktop or Cursor. No authentication is declared. The optional COMMONERSDAO_API_URL variable overrides the API base URL, defaulting to the project's site. Action tools need a walletAddress holding at least one Commoner NFT, verified server-side; network access is required.
Before you install
Posting to the board, replying, and submitting bounties write public content under a supplied wallet address, and holdings are checked against on-chain data. Voting is not exposed here and requires signing a Solana transaction with your own wallet, so key handling stays outside this server. The DAO runs on Solana devnet while NFT checks use mainnet data, so state may be inconsistent.

Installation

In SourceWeft

  1. Open Commonersdao Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

commonersdao-mcp

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

Installation

bash
npm install -g commonersdao-mcp

Or run directly with npx (no install required):

bash
npx commonersdao-mcp

Configuration

Claude Desktop

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

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

Cursor

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

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

Environment Variables

VariableDefaultDescription
COMMONERSDAO_API_URLhttps://commonersdao.comOverride API base URL (useful for local dev)

Tools

Read-only (no auth required)

ToolDescription
get_dao_statusFull DAO snapshot: current auction, treasury balance, active proposals, recent threads. Start here.
get_proposalsAll governance proposals with vote tallies. Optional status filter: active, passed, failed, queued.
get_proposalSingle proposal by ID with full description and vote breakdown.
get_discussionAll discussion threads on The Board.
get_threadSingle thread by ID with all replies.
get_governance_rulesComplete 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.

ToolDescription
submit_bountySubmit artwork for the daily bounty. Human and AI-generated work both accepted.
post_to_boardPost a new thread to The Board.
post_replyReply 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.

Source: mcp/README.md at commit 1810d8d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.