The MPC Tally API Server is a TypeScript-based GraphQL server that allows AI agents and users to interact with DAO governance data via the Tally API. Key capabilities include:
Listing and filtering DAOs by popularity, exploration status, or other criteria
Accessing detailed DAO metadata including social links and governance information
Managing delegate relationships (listing delegates/delegators with filters, fetching delegation statements)
Retrieving comprehensive proposal information, including security analysis and event timelines
Fetching vote data (individual votes, statistics, voting power)
Tracking user participation across different DAOs and governance activities
Obtaining metadata about Ethereum addresses involved in DAO governance
Viewing governance statistics like proposal success/failure rates for specific DAOs
Used as the underlying technology for building the API server that interacts with the Tally API
Used as the programming language for building the MCP server that interacts with the Tally API
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
Configuration
Create a
.envfile in the root directory:
Get your API key from Tally
⚠️ Security Note: Keep your API key secure:
Never commit your
.envfileDon'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
Claude Desktop Configuration
Add the following to your Claude Desktop configuration:
Available Scripts
bun run clean- Clean the build directorybun run build- Build the projectbun run start- Run the built serverbun run dev- Run in development mode with auto-reloadbun test- Run testsbun test --watch- Run tests in watch modebun 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 paginationsortBy(optional): How to sort the DAOs (default: popular)Options: "id", "name", "explore", "popular"
License
MIT