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