MODEL CONTEXT PROTOCOL

MCP GATEWAY

Connect autonomous agents to the Codex Hermes skill registry.

The Codex Hermes MCP Gateway allows agents to discover, fetch, and load reusable Markdown-based skills from the Codex Hermes registry. Skills are stored on IPFS through Pinata, indexed in Supabase, and exposed through a live backend endpoint.

GATEWAY STATUS

LIVE ENDPOINTS

GET /health

Check MCP backend status.

GET /api/skills

Return all active skills from the Codex Hermes registry.

GET /api/skills/:slug
GET /api/skills/:slug/content

MCP TOOL PLAN

codex_search_skills

Search active skills by keyword or category.

codex_get_skill

Fetch full metadata for a skill by slug or ID.

codex_get_skill_content

Fetch the Markdown content of a skill from IPFS.

codex_record_invocation

Record agent usage and increment skill usage count.

AGENT FLOW

PROTOCOL PIPELINE
Hermes Agent

Codex Hermes MCP Gateway

Supabase Skill Registry

Pinata / IPFS Skill.md

Agent loads skill instruction

EXAMPLE RESPONSE

GET /api/skills
{
  "count": 5,
  "skills": [
    {
      "name": "Twitter Thread Skill",
      "slug": "twitter-thread-skill",
      "category": "Development",
      "status": "active",
      "version": "1.0.0",
      "ipfs_cid": "bafk..."
    }
  ]
}

INTEGRATION STATUS

SYSTEM CHECKLIST
  • []Website registry live
  • []Skill publishing active
  • []Supabase connected
  • []Pinata/IPFS connected
  • []Render backend live
  • []HTTP API active
  • [ ]Hermes Agent MCP integration
  • [ ]Base Sepolia registry contract
  • [ ]Skill payment layer