Skip to content
View MCPVOT's full-sized avatar

Block or report MCPVOT

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
MCPVOT/README.md

Sustainable Decentralized Autonomous Ecosystem

Profile views


About

Building AI-powered tools for Colombian real estate, decentralized autonomous ecosystems, and on-chain agent economics. We created the c402 Protocol — a Colombian-first HTTP 402 Payment Required pattern — and the x402 Facilitator V2 for autonomous agent-to-agent payments on Base.

  • Pequi API — Colombia's first public real estate data API (276 barrios, 18 endpoints) with c402 monetization
  • x402 Protocol — HTTP 402 Payment Required for AI agents, deployed on Base mainnet, Coinbase ecosystem listed
  • Hermes Agent + RLM-Forge — Self-improving AI agents with recursive LM execution, running on DigitalOcean
  • Multi-model consensus — LLMs as independent policies aggregated by reward model for legal compliance

Projects

### [Pequi](https://xpequi.xyz) AI-powered real estate platform for Ibagué, Colombia. Ley 820 compliant contracts, property search, and AI chat assistant.

Code · Next.js 15 React 19 TypeScript Prisma PostgreSQL Clerk Vercel

### [MCPVotsAGI](https://github.com/MCPVOT/mcpvotsagi) Python SDK for agent orchestration, persistent memory, AI reasoning, and Darwin Gödel Machine evolution.

pip install mcpvotsagi · Python 3.11+ AsyncIO Redis WebSockets Ollama

### [MCPVOTS](https://github.com/MCPVOT/MCPVOTS) AI Agent Micro-Payment Ecosystem — VOTS token on Base, autonomous trading agents, x402 facilitation.

Live · Base VOT Token Chainlink VRF ERC-1155 NFTs Farcaster

### [Claude Agent MCP](https://github.com/MCPVOT/claude-agent-mcp) Personal AI agent with cross-platform MCP (Model Context Protocol) integration built on Claude.

Python MCP Protocol Claude API

### [MCP Agentic Wallet](https://github.com/MCPVOT/mcp-agentic-wallet) Open-source EIP-2612 Permit-based wallet sessions for AI agents — the reference implementation for paid MCP servers. Verify signatures, manage sessions, settle on-chain. No API keys, no recurring charges.

EIP-2612 EVM MCP Permit Base · Code

### [xpequi-api](https://github.com/MCPVOT/xpequi-api) Colombia's first public real estate data API. 18 endpoints, 276 barrios, c402 Protocol, AVM valuation, live UVR/IPC.

Code · 18 Endpoints c402 Protocol Open Finance TypeScript SDK Python SDK MCP Server

### [Hermes Agent](https://github.com/NousResearch/hermes-agent) Self-improving AI agent framework with skill learning loop, messaging gateway, 7 terminal backends. Runs on DigitalOcean with DeepSeek V4.

Self-improving Skill Loop DigitalOcean DeepSeek V4 RLM-Forge


x402 Facilitator & c402 Protocol

x402 V2 — Autonomous agent-to-agent payment facilitator on Base mainnet. ERC-1155 with Chainlink VRF for provably fair draws. Listed in the Coinbase ecosystem.

c402 Protocol — Colombian-first HTTP 402 Payment Required pattern for API monetization. When a FREE tier exceeds its limit, the API returns HTTP 402 with a Wompi checkout URL (PSE, Nequi, Daviplata, card). After payment, credits auto-activate. Zero crypto — atomic Redis deduction with SHA-256 webhook verification and 24h idempotency guard. See xpequi-api for implementation.


Agent Swarm Architecture

This is how the swarm actually works — not theory, not a roadmap. This is live infrastructure running across a Windows laptop and a DigitalOcean droplet, coordinating multiple AI agents that build, monitor, and ship autonomously.

The Swarm is the Moat

The real differentiator isn't the harness, the workers, or any single tool — it's the coordination layer: how a fleet of AI agents dispatch work, guard security, and audit code while no human is watching. This runs 24×7 across a Windows laptop and a DigitalOcean droplet. The wiring between agents is the moat.

Every task flows through a coordinated swarm that does three things autonomously:

1 · Coordinate. The Orchestrator decides, routes, and verifies. Sub-agents (OpenCode, Cline, Codex) execute in parallel — one task per agent, isolated workdirs, each with a completion ritual that writes findings to disk. No agent trusts another agent's self-report; every output is verified before it counts.

2 · Enforce security. automated security runs as an always-on security lane — network port scans, secret-scanning across repos and logs, credential-permission enforcement, and spend monitoring. Every agent commit uses a neutral identity, secrets never leave .env, and any token that surfaces in a transcript gets rotated on sight.

3 · Audit code autonomously. A deep memory engine (persistent agent memory) + a recursive language-model forge (RLM-Forge) review changes through bounded recursive calls. The 3-stage evaluation gate (lint → typecheck → integration) runs before anything merges. The swarm catches what a solo coder would miss — and it does it on schedule, not on mood.

The Trilogy

Three roles, one architecture. Every task flows through this pipeline:

Role What it does What runs it
Orchestrator Decides, routes, verifies, logs decisions. The harness — never a worker. Hermes Agent (laptop, interactive)
Oracle-Graph Knowledge layer. persistent agent memory engine + repo source-of-truth. Answers "what do we know?" persistent agent memory + source-of-truth docs
Architect Builds. Sub-agents execute in parallel — one task per agent, isolated workdirs. Cline + OpenCode (GO 2× path) + Codex (parallel lane)

automated security wraps all three as the security lane: network ports, secret-scanning, credential permissions, spend monitoring. It runs 24×7 on the droplet and never sleeps.

Multi-Profile Swarm

Six independent Hermes profiles run on the laptop, each a fully isolated seat with its own memory, sessions, cron, skills, and secrets. Zero cross-contamination — each profile is its own world:

PROFILES (laptop)
├── Profile A — interactive architect brain, secure agent mesh bridge
├── Profile B — project operations seat (Next.js, deploy gate)
├── Profile C — project operations seat (streetwear, Three.js)
├── Profile D — CRM seat (Rust middleware, API bridge)
├── Profile E — agency operations (Laravel, GoHighLevel, 150-market)
└── Profile F — orchestrator / cross-project coordination

Each profile:
  ├── config.yaml (model block: deepseek-v4-flash + openrouter)
  ├── memories/ (MEMORY.md + USER.md — persistent across sessions)
  ├── skills/ (reusable procedures — the self-improving layer)
  ├── cron/ (scheduled jobs with delivery + retry)
  ├── sessions/ (FTS5-backed SQLite transcript store)
  └── .env (ecosystem-specific secrets — NEVER shared)

Hard isolation rule: a chat belongs to exactly one profile. Never work on project B's tasks inside profile A's chat. Never carry profile A's context into profile B's work. Secrets stay per-ecosystem — personal keys never enter project repos, project keys never enter personal docs.

Sub-Agent Dispatch (Swarm Workers)

The Orchestrator dispatches tasks to workers. Each worker gets one task, an isolated workdir, and a completion ritual (write findings to a file). Worker self-reports are not trusted facts — the Orchestrator verifies every output.

Worker Role Lane
OpenCode Fast coding agent, CLI-native, default sub-agent Primary builder
Cline Autonomous coding with MCP tool access MCP-integrated worker
Codex Parallel lane — features, PR reviews, batch fixes Parallel fan-out

Dispatch patterns:

  • delegate_task — quick parallel subtasks (minutes). Each child gets isolated context + terminal. Only the summary returns. Orchestrator verifies.
  • Spawned processes — long autonomous missions (hours/days). Full tool access, PTY mode via tmux, independent sessions.
  • Background processes — servers, watchers, cron jobs. notify_on_complete=true for bounded tasks; silent for daemons.

persistent agent memory Memory Engine

persistent agent memory is the persistent knowledge layer — the Oracle-Graph's backbone. It runs on the droplet and stores session memory across ~/.agents/skills and a persistent memory store session archives.

persistent agent memory graph
├── Session transcripts (what happened, what worked, what failed)
├── Skill library (reusable procedures — the self-improving layer)
├── Keyed memory (who the user is, preferences, environment, lessons)
├── Per-ecosystem isolation (secrets never cross boundaries)
└── Cross-session recall (FTS5 search over SQLite transcript store)

Every Hermes profile carries MEMORY.md (environment facts, tool quirks, conventions) and USER.md (who the user is, preferences, corrections). These persist across sessions — the swarm remembers what worked and what didn't.

The Ouroboros Cycle

The development loop — spec-first, validated at every stage:

  ┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
  │ INTERVIEW │────▶│   SEED   │────▶│ EXECUTE  │────▶│ EVALUATE │
  │  Capture  │     │ Generate │     │ OpenCode │     │ 3-stage  │
  │  require- │     │  specs   │     │  builds  │     │   gate   │
  │  ments    │     │          │     │          │     │          │
  └──────────┘     └──────────┘     └──────────┘     └────┬─────┘
       ▲                                                      │
       └────────────────── Magic Context ─────────────────────┘
        (cross-session memory preserves developer intent)
  1. Interview — capture requirements (Ouroboros interviews the user)
  2. Seed — generate structured specs from the interview
  3. Execute — OpenCode builds from the spec
  4. Evaluate — 3-stage gate: lint → typecheck → integration before merge

Magic Context preserves developer intent across sessions so the loop never loses track. The cycle repeats until the evaluation gate passes.

Rust Workflows

Rust powers the middleware layer — high-performance, type-safe API bridges that sit between external services and the agent swarm:

Rust middleware (axum)
├── REST API proxy (fans, notes, PPVs, send endpoints)
├── Webhook handler (POST /webhooks, HMAC-SHA256 signed)
├── SSE fan-out (real-time event streaming to UI)
├── Anti-spam engine (72h cooldown, group-overlap dedup)
├── Plan-gated webhooks (Basic+ — 402 on expired plan)
├── Honest error model:
│     no creds → 501/201-stub
│     upstream fail → 502
│     cooldown → 409
│     NEVER false success
└── Stub fallback on expired plan — never 500

The Rust layer is the bridge between external APIs (rate-limited, plan-gated) and the Hermes profiles that consume them. It handles rate limiting (sliding-window 429s), HMAC verification, and fan-id validation with percent-encoding before URL interpolation.

RLM-Forge (Recursive Language Model)

RLM-Forge is the recursive execution engine — a forge where the Ouroboros owns recursion and Hermes performs bounded inner calls.

RLM-Forge
├── evidence-gated recursion (every recursive call must show evidence)
├── Bounded inner calls (Hermes executes, RLM-Forge validates)
├── Deployed on DigitalOcean alongside Hermes gateway
└── Recursive depth limits (never infinite — always bounded)

Agent Protocols

Protocol What it does
MCP (Model Context Protocol) Standardized tool access — servers expose tools, agents call them. Used across the entire swarm.
A2A (Agent-to-Agent) WebSocket communication between autonomous agents. Redis-backed persistent memory. MCPVotsAGI implements this.
x402 (HTTP 402 Payment) Autonomous agent-to-agent payments on Base. Agents pay agents — no human in the loop.
SSE Streaming Real-time event streaming from Rust middleware to UI panels.

Truth Order (Decision Hierarchy)

When the swarm needs to know what's true, it reads in this order — never out of sequence:

1. source-of-truth docs    ← the source of truth (read first, always)
2. docs/VERSIONS.md     ← what version of what is deployed
3. AGENTS.md             ← project rules and constraints
4. Reports               ← what we told the stakeholder
5. Research              ← background context, lowest authority

Git Identity Rule

Every commit across the entire swarm uses MCPVOT <mcpvot@users.noreply.github.com>never a personal identity. This is a hard rule with a doxing prevention history. Secrets live in .env files only — never in repos, logs, chat transcripts, or commits. Tokens seen in chat get rotated immediately.


My Agent Stack

How I actually build: one harness, three workers — all open-source, API-driven, no subscriptions.

Tool Role Why
Hermes Agent The harness (the brain) Self-improving via skills + persistent memory, multi-platform gateway (Telegram/Discord/Slack/WhatsApp), cron, MCP
OpenCode Worker 1 Fast coding agent, CLI-native, my default sub-agent
Cline Worker 2 Autonomous coding with MCP tool access
Codex Worker 3 Parallel lane — features, PR reviews, batch fixes, dual-provider

The pattern: Hermes decides, routes, and verifies; the three workers execute in parallel (research fan-outs, bug-hunts, reviews). Skill files + keyed memory make the stack portable — swap any harness and the layer survives.


Tech Stack

Technologies
Languages TypeScript Python Rust Solidity SQL
Frontend Next.js React Tailwind
AI / LLM Claude DeepSeek Qwen Ollama
AI Platforms OpenRouter · Z.AI · Hermes Agent · RLM-Forge · OpenCode · Claude Code
Agent Frameworks Hermes Agent (NousResearch) — self-improving AI agent with skill learning loop, messaging gateway, 7 terminal backends · RLM-Forge (Q00) — recursive LM forge with evidence-gated recursion · Ouroboros · MCP Protocol · A2A Protocol · OpenClaw
Blockchain Ethereum Base Solana
Smart Contracts Solidity ERC-20 · ERC-721 · ERC-1155 · ERC-4804 · Uniswap V4 · Chainlink VRF · x402 Protocol
Payments / Monetization x402 V2 Facilitator (Base mainnet) · c402 Protocol (HTTP 402 — Wompi + Redis · zero crypto) · Wompi Web Checkout · PSE · Nequi · Daviplata · COP pricing · Prepaid Credits · Subscriptions
Web3 / Identity ENS (.eth) · Basename (mcpvot.base.eth) · Farcaster · Warpcast · IPFS · Agent Registration (.well-known)
Database PostgreSQL Redis SQLite Neon Upstash
Infra Vercel Docker GitHub Actions
Automation n8n Workflows · DeerFlow · VoltAgent · Cron Jobs · Message Queues · Autonomous Pipelines
Bots / Comms Telegram Bot · WhatsApp (Meta + Twilio) · Webhook Handlers · AI Chat Streaming
AI Infra MCP Servers · A2A (Agent-to-Agent) · DGM (Darwin Gödel Machine) · Memory MCP · Gemini CLI Server · persistent agent memory Memory Engine · secure agent mesh VPN (agent-to-agent mesh)
Monitoring GitHub Actions CI/CD · Vercel Cron · Health Checks · Sentry Error Tracking · Rate Limiting (Upstash) · automated security (security lane 24×7)
Protocols MCP (Model Context Protocol) · A2A · x402 (HTTP 402 Payment) · ERC-4804 · SSE Streaming · Ouroboros (spec-first dev cycle)

GitHub Stats

GitHub Stats Top Languages

GitHub Streak

github-snake


Connect

Pinned Loading

  1. xpequi-api xpequi-api Public

    Pequi API — Colombia's First Real Estate Data API. SDK, MCP server, and documentation.

    JavaScript 1