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
.env
file in the root directory:
- 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
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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
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.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server enabling AI assistants to generate images through OpenAI's DALL-E API with full support for all available options and fine-grained control.Last updated -11JavaScriptMIT License
- -securityFlicense-qualityA server that allows AI assistants to access and retrieve Linear ticket data through the Model Context Protocol (MCP) standard, currently focused on fetching a user's todo tickets.Last updated -685TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server implementation that enables AI assistants to interact with Apollo.io data, performing operations like people/organization enrichment, searching, and retrieving job postings through natural language commands.Last updated -718TypeScriptMIT License
- -securityAlicense-qualityA Model Context Protocol (MCP) server that provides read-only TDengine database queries for AI assistants, allowing users to execute queries, explore database structures, and investigate data directly from AI-powered tools.Last updated -7PythonMIT License