DOCUMENTATION

DOCS

Publish, discover, and invoke AI agent skills via Codex Hermes.

QUICK LINKS

Website →MCP Backend →MCP Gateway Docs →Explore Skills →

TABLE OF CONTENTS

OVERVIEW

Codex Hermes is a live AI skill registry for Hermes Agent and autonomous agents.

Website: https://codex-hermes.vercel.app
MCP Backend: https://codex-hermes-mcp.onrender.com

Skills are reusable Markdown documents that define capabilities, instructions, and context for AI agents. Files are pinned to IPFS via Pinata. Metadata is indexed in Supabase. A live HTTP API on Render exposes the registry to agents.

ARCHITECTURE

┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
│  Publisher  │────▶│  Codex Hermes    │────▶│   Pinata    │
│  (Browser)  │     │  Website (Vercel)│     │   (IPFS)    │
└─────────────┘     └────────┬─────────┘     └─────────────┘
                             │
                             ▼
                      ┌──────────────┐
                      │   Supabase   │
                      │  (Metadata)  │
                      └──────┬───────┘
                             │
┌─────────────┐              │
│ Hermes Agent│────▶┌────────▼─────────┐
│             │     │ MCP Gateway       │
└─────────────┘     │ (Render Backend)  │
                    └──────────────────┘

MCP HTTP API

Live backend: https://codex-hermes-mcp.onrender.com

GET /health
  Check backend status.

GET /api/skills
  List all active skills.

GET /api/skills/:slug
  Fetch skill metadata by slug.

GET /api/skills/:slug/content
  Fetch Markdown skill content from IPFS.

Example:
https://codex-hermes-mcp.onrender.com/api/skills
https://codex-hermes-mcp.onrender.com/api/skills/token-launch-post/content

Full protocol documentation: https://codex-hermes.vercel.app/mcp

PUBLISHING A SKILL

1. Write your skill as a Markdown (.md) file.
2. Open https://codex-hermes.vercel.app/publish and complete the form.
3. Upload your .md file — it is pinned to IPFS via Pinata.
4. Metadata is saved to Supabase with status "active".
5. Share the skill detail page or MCP API URL with agents.

SKILL FILE FORMAT

# Skill Name

## Description
Brief description of what this skill does.

## Instructions
Step-by-step instructions for the AI agent to follow.

## Parameters
- param1: Description of parameter 1
- param2: Description of parameter 2

## Examples
Example usage scenarios and expected outputs.

AGENT INTEGRATION

Hermes Agent and other autonomous agents can integrate via:

1. HTTP API — fetch skills from https://codex-hermes-mcp.onrender.com/api/skills
2. MCP tools (planned) — codex_search_skills, codex_get_skill, codex_get_skill_content, codex_record_invocation

Agent flow:
  Agent → MCP Gateway → Supabase → IPFS → Load skill.md instructions

DATABASE SCHEMA

-- skills table
CREATE TABLE skills (
  id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
  name TEXT NOT NULL,
  slug TEXT UNIQUE NOT NULL,
  description TEXT NOT NULL,
  category TEXT NOT NULL,
  author_wallet TEXT NOT NULL,
  author_name TEXT NOT NULL,
  ipfs_cid TEXT NOT NULL,
  ipfs_url TEXT NOT NULL,
  version TEXT NOT NULL DEFAULT '1.0.0',
  price NUMERIC DEFAULT 0,
  status TEXT DEFAULT 'active',
  usage_count INTEGER DEFAULT 0,
  created_at TIMESTAMPTZ DEFAULT now()
);

-- invocations table
CREATE TABLE invocations (
  id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
  skill_id UUID REFERENCES skills(id),
  agent_name TEXT NOT NULL,
  user_wallet TEXT,
  source TEXT DEFAULT 'mcp',
  created_at TIMESTAMPTZ DEFAULT now()
);

DEPLOYMENT

Website (Vercel): https://codex-hermes.vercel.app
MCP Backend (Render): https://codex-hermes-mcp.onrender.com

Website deploy:
1. Connect repository to Vercel.
2. Configure public Supabase keys and server secrets in the Vercel dashboard.
3. Deploy automatically on push.

MCP backend is deployed separately on Render and reads from the same Supabase registry.

[ PUBLISH SKILL ][ MCP GATEWAY ][ TEST API ]