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.