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 - [x] Local functions - [x] Hosted functions - [ ] Registry - [ ] Publish - [ ] Browse - [x] Mcp support - [x] Local Stdio - [x] Local SSE - [ ] Hosted SSE - [x] Slop Support - [x] Local Slop - [x] Hosted Slop - [ ] Tool Composability - [ ] Grouping - [ ] Flows - [ ] Triggers / Tags - [ ] Extends - [x] 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](packages/cli/README.md) 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)
- Setup a Valtown account
- 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)
[](https://badge.fury.io/js/jsonblog-schema)
[](https://github.com/jsonblog/jsonblog-schema/actions/workflows/ci.yml)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
- 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:
- **Anyone** can create and share tools that extend AI capabilities
- **Everyone** has access to a rich ecosystem of tools regardless of their technical background
- **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:
- **Registry**: For tool storage and discovery
- **CLI**: For interacting with the registry and managing tools
- **MCP Server**: For executing tools within agent workflows
Currently, [ValTown](https://www.val.town) 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.