Tally DAO Governance

by crazyrabbitltc

4 stars
1 downloads
Not rated
GitHub

About

A server that allows AI agents to interact with the Tally API to access DAO governance data, proposals, and metadata using Model Context Protocol (MCP), built with TypeScript and GraphQL.

Details

Author
crazyrabbitltc
Repository
crazyrabbitLTC/mpc-tally-api-server
GitHub stars
4
Downloads
1
License
MIT License
Categories
AI, Design, Developer Tools, Search, Infrastructure, Frontend
Tags
#analytics, #visualization, #data

- 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

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Tally DAO Governance
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 /path/to/mpc-tally-api-server/build/index.js
    Environment
    • TALLY_API_KEY your_api_key_here

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

bun install


Add the following to your Claude Desktop configuration:

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

list_daos

Lists DAOs sorted by specified criteria. Parameters: limit (optional integer), afterCursor (optional string), sortBy (optional string - options: 'id', 'name', 'explore', 'popular')

Claude Desktop / Cursor

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

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

Linux

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

Macos

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

Windows

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

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

1. Create a .env file in the root directory:

TALLY_API_KEY=your_api_key_here

2. 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.
No reviews yet — be the first

Sign in to leave a review

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

Email sign in

No reviews posted yet.