MPC Tally API Server
A Model Context Protocol (MCP) server that enables AI agents to interact with the Tally API, providing access to DAO governance data, proposals, and metadata. Built with TypeScript and GraphQL, it offers a secure and efficient way to fetch and sort DAO information through standardized MCP functions.
what is MPC Tally API Server?
MPC Tally API Server is a Model Context Protocol (MCP) server that enables AI agents to interact with the Tally API, providing access to DAO governance data, proposals, and metadata.
how to use MPC Tally API Server?
To use the MPC Tally API Server, clone the repository, install dependencies, configure your API key, and run the server using the provided commands.
key features of MPC Tally API Server?
- 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
use cases of MPC Tally API Server?
- Fetching and displaying DAO governance data for analysis.
- Integrating DAO information into AI applications.
- Supporting decentralized governance through accessible metadata.
FAQ from MPC Tally API Server?
- What is the purpose of the MPC Tally API Server?
It allows AI agents to fetch and interact with DAO governance data efficiently.
- How do I secure my API key?
Keep your API key secure by not committing it to version control and using environment variables for configuration.
- Can I customize the sorting of DAOs?
Yes! You can sort DAOs by various criteria such as popularity or exploration status.
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
.envfile 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
.envfile - 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 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
