blah-mcp

PROJECT IN EXTREME POC MODE - NOTHING STABLE AT ALL - DOCS AND VISION ARE PURELY NOTES

BLAH - Barely Logical Agent Host - Update #1

(think npmjs for tools)

Once this list is fully done, the BLAH JSON schema will be finalized.

• Tools
  • Local functions
  • Hosted functions
  • Registry
    • Publish
    • Browse
  • Mcp support
    • Local Stdio
    • Local SSE
    • Hosted SSE
  • Slop Support
    • Local Slop
    • Hosted Slop
  • Tool Composability
    • Grouping
    • Flows
    • Triggers / Tags
  • Extends
    • Local blah.json
    • Hosted blah.json
  • Debugging
    • Playground
    • Logging

Notes:

• The flows will be using a subset of agnt.gg's flow schema
• Extend means you can compose blah.json's in any way you like. (think what if you just want to include a designers you follow tools)
• The registry means we will have a convenient way to just push and pull functions (tools)

BLAH - Barely Logical Agent Host

BLAH is an open-source ecosystem for managing, distributing, and executing AI agent tools using the Model Context Protocol (MCP). It provides a decentralized registry for MCP servers that promotes transparency, security, and community-driven development.

Project Structure

This project is organized as a monorepo using Turborepo:

• packages/cli - The main BLAH CLI tool for working with MCP
• apps/web - Web interface for BLAH
• apps/docs - Documentation site

Getting Started

Prerequisites

• Node.js >= 18.18.0 (Node 20+ recommended)
• pnpm

Installation

Quick Start with the CLI

See the CLI README for detailed instructions on using the BLAH CLI.

Currently working on

• Need a way to debug mcp servers using any model/ide
• Think about portals
• lisa watts came up with "auton", likely what i am going to suggest

Unrelated Ideas

• Need save state in ideas so you don't lose stuff (if you hadn't comitted)
• upvotes for social tooling
• automatic error rate
• share your tool combination results

Using a local blah.json

Hosted blah.json (Valtown)

Getting started (hosted)

1. Setup a Valtown account
2. Create a new HTTP function named blah

Adding to your Client

• Claude
  • Desktop
  • Code (CLI)
• Cursor
• Cline
• Windsurf
• BLAH Client
• Are there any nice web clients yet

Development

I am still working on tools to make development not shit.

Logging

While developing this, I want to send logs from everybodies clients to just figure out all the fucking errors the clients are throwing due to different configures.

Playground

So far just a basic client that lists prompts, resources, and tools. Could be interactive later, and should also run against tests.

Needs improvement

• Valtown is the current wrapper, need to be an alternative maybe using Vercel functions or some shit.
• Need a nice strategy for composability

Credits

• Lisa Watts
• Travis
• Wombat

AI GENERATED BULL SHIT (the above is authentic)

• mcp server version badge
• registry uptime status

What is BLAH?

BLAH is an open-source ecosystem for managing, distributing, and executing AI agent tools using the Model Context Protocol (MCP). It provides a decentralized registry for MCP servers that doesn't suffer from misaligned incentives, promoting transparency, security, and community-driven development.

Key Features:

• Open-source infrastructure that any system (IDE, AI platform, etc.) can connect to
• Language-agnostic tool registry supporting unlimited tool selection
• Robust security through optional signing and verification of MCP servers
• Comprehensive CLI for publishing, discovering, and managing tools
• Support for various tool types: functions, REST endpoints, local files, or standard manifests

🔍 Vision

BLAH aims to be the foundation for a new generation of AI tools that can be easily shared, discovered, and composed. We envision a future where:

1. Anyone can create and share tools that extend AI capabilities
2. Everyone has access to a rich ecosystem of tools regardless of their technical background
3. Every system can integrate with this ecosystem through standard protocols

🚀 Getting Started

Installation

Basic Usage

📖 Core Concepts

The Registry

BLAH's registry is designed with lessons learned from package managers like npm, focusing on:

• Transparency: All infrastructure code is open-source
• Decentralization: Storage options include local, cloud, IPFS, or gists
• Security: Optional signing of MCP servers with verification
• Governance: Community-driven with no single entity controlling the ecosystem

Agent Behavior

BLAH supports various agent interaction patterns:

• Parallel execution
• Recursive tool calls
• Branching workflows
• Sequential processing
• Complex graph-based workflows

Tool Definition

A tool in BLAH is fundamentally a function, but can be represented as:

• Code snippets
• RESTful endpoints
• Local executables
• Standard manifests (SLOP, agents.json)

Every tool should explicitly document how it's invoked, though this isn't mandatory.

🛠️ CLI Commands

BLAH comes with a comprehensive CLI:

📋 Manifests

BLAH uses a manifest file (blah.json) to define tools and their dependencies. This manifest can exist:

• In a project workspace
• In the home directory
• Hosted in the cloud
• As a gist or on IPFS

Example blah.json:

🔄 Standards Support

BLAH supports and aims to be compatible with:

• Model Context Protocol (MCP)
• SLOP (Structure for Language Operator Protocols)
• agents.json
• [Your own custom protocols through converters]

🌟 Discovery and Metadata

Tools in BLAH are organized using:

• Tags (e.g., #TOOLBELT)
• Semantic metadata for intuitive navigation
• Usage analytics for popularity-based recommendations
• User-based recommendations (tools used by similar users)

🏗️ Architecture

BLAH consists of three main components:

1. Registry: For tool storage and discovery
2. CLI: For interacting with the registry and managing tools
3. MCP Server: For executing tools within agent workflows

Currently, ValTown serves as the primary backend for registry storage and compute, though alternative implementations are welcome.

🔒 Security & Accountability

BLAH takes security seriously:

• Optional signing of MCP servers
• Code execution in sandboxed environments
• Comprehensive logging for accountability
• Compliance with local laws and regulations

🚧 Roadmap

• Host the MCP server on cloud platforms (e.g., Cloudflare Workers)
• Create a web-based tool explorer and documentation site
• Improve debugging and developer experience
• Develop a tool creation wizard/generator
• Implement tool recommendation system

🧠 Future Ideas

• User behavior sharing for personalized tool recommendations
• Scheduled agent execution through cron-like mechanisms
• Decentralized governance model for registry management
• Extension ecosystem for custom registry implementations

🤝 Contributing

Contributions are welcome! Check back soon for detailed contribution guidelines.

👏 Credits

Special thanks to Lisa and Wombat for their invaluable contributions to this project.

📄 License

BLAH is released under the MIT License. See the LICENSE file for details.