Friday MCP Server

Successor MCP server for Friday, built on the same FastMCP pattern but organized as a standalone package with a self-extension workflow.

What it provides

• Core MCP server with FastMCP entrypoints and reusable registration modules.
• Research tools for web search, URL fetch, and live world-news summaries.
• Workspace tools for reading, writing, listing, and executing commands inside a configured workspace root.
• Self-extension tools that let Friday validate, install, activate, deactivate, remove, and roll back skills.
• Prompt and resource surfaces so clients can inspect the active skill catalog and get templates for researching or authoring new skills.

Skill model

Skills are markdown documents with YAML front matter stored under skills/installed/.

• They are data-driven prompt assets, not arbitrary Python plugins.
• New skills can be created from generated markdown or downloaded from a URL.
• Successful installs are activated automatically by default.
• Reinstalling an existing skill creates a timestamped backup for rollback.
• Each installed skill records provenance, compatibility, checksum, and activation state.

Example:

---
id: web-research
name: Web Research
version: 1.0.0
description: Gather and compare information from multiple current sources.
capabilities:
  - search
  - citation
min_server_version: 0.1.0
---
Use web search to gather multiple sources before drawing conclusions.
Prefer primary or official sources when possible.

Quick start

uv sync --extra dev
cp .env.example .env
uv run friday-mcp-server

By default the server runs over stdio. To run over SSE instead:

FRIDAY_MCP_TRANSPORT=sse uv run friday-mcp-server

Friday integration

Point a Friday MCP client at this server's transport:

• stdio clients: invoke uv run friday-mcp-server
• SSE clients: run with FRIDAY_MCP_TRANSPORT=sse and connect to /sse

The server exposes:

• fetch_url, search_web, get_world_news
• list_workspace, read_file, write_file, run_bash
• list_skills, get_skill, validate_skill_markdown
• install_skill_from_markdown, install_skill_from_url
• activate_skill, deactivate_skill, remove_skill, rollback_skill
• get_current_time, get_system_info, format_json, word_count

Repository layout

src/friday_mcp_server/
  config.py
  server.py
  skill_store.py
  prompts/
  resources/
  tools/
skills/
  installed/
tests/

Development

uv run pytest