Use This MCP server To

Fetch DAO governance data for AI analysis Retrieve DAO proposals for decision-making agents Access DAO metadata including social links Sort DAOs by popularity or exploration status Paginate large DAO datasets for efficient querying Integrate DAO data into AI-driven governance tools

README

MPC Tally API Server

A Model Context Protocol (MCP) server for interacting with the Tally API. This server allows AI agents to fetch information about DAOs, including their governance data, proposals, and metadata.

Features

List DAOs sorted by popularity or exploration status
Fetch comprehensive DAO metadata including social links and governance information
Pagination support for handling large result sets
Built with TypeScript and GraphQL
Full test coverage with Bun's test runner

Installation

# Clone the repository
git clone https://github.com/yourusername/mpc-tally-api-server.git
cd mpc-tally-api-server

# Install dependencies
bun install

# Build the project
bun run build

Configuration

Create a .env file in the root directory:

TALLY_API_KEY=your_api_key_here

Get your API key from Tally

⚠️ Security Note: Keep your API key secure:

Never commit your .env file
Don't expose your API key in logs or error messages
Rotate your API key if it's ever exposed
Use environment variables for configuration

Usage

Running the Server

# Start the server
bun run start

# Development mode with auto-reload
bun run dev

Claude Desktop Configuration

Add the following to your Claude Desktop configuration:

{
  "tally": {
    "command": "node",
    "args": [
      "/path/to/mpc-tally-api-server/build/index.js"
    ],
    "env": {
      "TALLY_API_KEY": "your_api_key_here"
    }
  }
}

Available Scripts

bun run clean - Clean the build directory
bun run build - Build the project
bun run start - Run the built server
bun run dev - Run in development mode with auto-reload
bun test - Run tests
bun test --watch - Run tests in watch mode
bun test --coverage - Run tests with coverage

API Functions

The server exposes the following MCP functions:

list_daos

Lists DAOs sorted by specified criteria.

Parameters:

limit (optional): Maximum number of DAOs to return (default: 20, max: 50)
afterCursor (optional): Cursor for pagination
sortBy (optional): How to sort the DAOs (default: popular)
- Options: "id", "name", "explore", "popular"

License

MIT

mpc-tally-api-server FAQ

How do I install the mpc-tally-api-server?

Clone the repository, install dependencies with bun install, then build the project using bun run build.

How do I configure the API key for the server?

Create a .env file in the root directory with your TALLY_API_KEY obtained from https://tally.xyz. Keep this key secure and do not expose it publicly.

What programming languages and technologies does this server use?

The server is built with TypeScript and GraphQL, ensuring type safety and efficient data querying.

How does the server handle large result sets?

It supports pagination to efficiently manage and fetch large datasets of DAO information.

Is the mpc-tally-api-server tested?

Yes, it has full test coverage using Bun's test runner to ensure reliability.

How does the server ensure security of the API key?

Users are advised to never commit the .env file, avoid exposing the API key in logs, and keep it confidential.

Can this server be used with multiple LLM providers?

Yes, it is compatible with various LLMs including OpenAI, Anthropic Claude, and Google Gemini through the MCP standard.

What kind of DAO data can I access?

You can access governance data, proposals, metadata, and social links related to DAOs.