Skip to main content
Glama
deenesjakoruzh
ariobarin

Compass MCP

by ariobarin
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

Compass MCP

Read-only MCP access to the current reviewed Compass profile and selected skills for regular ChatGPT chat mode.

Website: https://compass.ariobarin.com/

MCP endpoint: https://compass.ariobarin.com/mcp

Freshness model

The server does not bundle Compass content. For each MCP request it resolves ariobarin/compass main to one Git commit, then loads codex/AGENTS.md, manifests/portable-files.json, and every selected skill from that exact revision.

Normal requests cache the branch head for at most 15 seconds. Immutable revision catalogs are reused inside a Worker isolate. GET /healthz?fresh=1 bypasses the branch-head cache and returns source_revision, so CI can compare production with a known Compass commit.

A single request never mixes files from different Compass revisions.

The homepage is rendered by the same Worker from the same revision-pinned catalog. It shows the live source revision, branch, and selected skill list without maintaining a second copy of Compass content.

Related MCP server: okfy

Tools

  • get_profile returns codex/AGENTS.md from the request revision.

  • list_skills returns the manifest-selected skill catalog and revision.

  • get_skill returns one selected SKILL.md from the request revision.

  • search and fetch expose the same revision-pinned documents through standard read-only knowledge shapes.

Local checks

Use Node.js 22 or later.

npm install
npm run build
npm test
npm run smoke:worker

Run the local HTTP server with npm run dev. It listens on 127.0.0.1:3000 unless HOST or PORT is set.

Production verification

npm run smoke:remote
npm run verify:remote

verify:remote fails when the production Worker reports a Compass revision different from current main. Set EXPECTED_COMPASS_REVISION to compare against a specific commit, such as a GitHub Actions GITHUB_SHA.

Deploy

Authenticate Wrangler with the Cloudflare account that owns ariobarin.com, then run:

npm run deploy
npm run smoke:remote
npm run verify:remote

Deployments change server code only. Compass content changes do not require a Worker deployment.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • lifeos-mcp

    bwats
    F
    license
    A
    quality
    C
    maintenance
    Provides MCP-compatible AI agents with read access to a LifeOS knowledge base, exposing identity, preferences, projects, wiki, skills, and rules via tools and resources.
    17
    -

  • okfy

    0dust
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to search, read, and traverse documentation bundles in Open Knowledge Format via MCP tools.
    298 npm
    72
    MIT

  • vault-mcp-bridge

    kizz-tech
    A
    license
    Not graded
    quality
    B
    maintenance
    Read-only MCP bridge that exposes secure search and fetch tools over an Obsidian-compatible Markdown vault, enabling ChatGPT to query notes without write access.
    1
    Apache 2.0

  • frasma

    francemazzi
    F
    license
    Not graded
    quality
    C
    maintenance
    Exposes read-only MCP tools for discovering Frasma's profile and knowledge base, accessing the diagnostic framework, and preparing validated process briefs and diagnostic summaries with handoff URLs. It enables agents to gather operational context and generate quote-ready process assessments without sending emails.
    -