Skip to main content
Glama
Sign In
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: C2C Bridge

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

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • vault-mcp-bridge

    kizz-tech
    A
    license
    Not graded
    quality
    D
    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

  • C2C Bridge

    leowood2000
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables the ChatGPT web app to securely read selected files, git state, and test output from a local workspace through OAuth-protected read-only MCP tools, so TeleAgent retains full execution control.
    1
    MIT

  • Paseo Architect Bridge

    Ramidoz
    A
    license
    Not graded
    quality
    A
    maintenance
    Gives ChatGPT read-only visibility into Paseo-managed coding sessions and repository state, letting users list running agents, review what changed since the last update, inspect bounded diffs and pull project context to reason about architecture and the next task.
    MIT

  • AgentHub MCP Server

    NekrozDEV
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables MCP-compatible AI coding agents to retrieve shared skills, project architecture maps, vault secret statuses, handoff checkpoints, external MCP definitions, and code audit results on demand across multiple IDEs. It reduces context tokens and supports secure, cross-agent task continuity.
    MIT