Mpc Tally Api Server

🚀 MPC Tally API Server

A Model Context Protocol (MCP) server designed to interact with the Tally API. This server enables AI agents to retrieve information about DAOs, including their governance data, proposals, and metadata.

🚀 Quick Start

The MPC Tally API Server is a powerful tool that allows AI agents to access comprehensive DAO information. Follow the steps below to get started.

✨ Features

• List DAOs by popularity or exploration status.
• Retrieve comprehensive DAO metadata, including social links and governance information.
• Support pagination for handling large result sets.
• Built with TypeScript and GraphQL.
• Have full test coverage using 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. Obtain your API key from Tally.

⚠️ Important Note

Protect your API key:

• Never commit the .env file.
• Do not expose the API key in logs or error messages.
• Replace the key immediately if it is compromised.
• Use environment variables for configuration.

💻 Usage Examples

Basic Usage

Run the Server

# Start the server
bun run start

# Run in development mode with auto-reloading
bun run dev

Configure Claude Desktop

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"
    }
  }
}

Advanced Usage

Here are some useful scripts for different scenarios:

• 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-reloading.
• bun test - Run tests.
• bun test --watch - Run tests in watch mode.
• bun test --coverage - Run tests with coverage.

📚 Documentation

API Functions

The server exposes the following MCP functions:

list_daos

List DAOs according to specified criteria.

Parameters:

• limit (optional): The maximum number of DAOs to return (default: 20, maximum: 50).
• afterCursor (optional): Pagination cursor.
• sortBy (optional): How to sort the DAOs (default: popular).
  • Available values: "id", "name", "explore", "popular".

📄 License

This project is licensed under the MIT license.