Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hellofriday.ai/llms.txt

Use this file to discover all available pages before exploring further.

is an open standard for connecting AI agents to external systems — databases, APIs, filesystems, and services. Friday manages MCP server processes: declare a server in your workspace and every llm or user agent in that workspace can call its tools.

​
Declaring a server

workspace.yml
tools:
  mcp:
    servers:
      github:
        transport:
          type: stdio
          command: npx
          args: ["-y", "@modelcontextprotocol/server-github"]
        env:
          GITHUB_PERSONAL_ACCESS_TOKEN: from_environment
      time:
        transport:
          type: stdio
          command: uvx
          args: ["mcp-server-time", "--local-timezone", "UTC"]
Each key under servers is the server ID you’ll use to prefix tool names. The transport block tells Friday how to start the server. Use from_environment for credentials — the daemon injects them at process start.

​
Tool naming

Tools must be referenced as serverId/toolName in an agent’s tools array: 
# Server ID is "github", tool name is "create_pull_request_review"
tools:
  - github/create_pull_request_review
  - github/get_pull_request
Run friday agent list -w <workspace> to see the exact tool names available from each configured server. Built-in platform tools (memory_save, memory_read) have no prefix and require no MCP server declaration — they’re always available: 
tools:
  - memory_save
  - memory_read
  - github/search_issues

​
Using tools in an llm agent

workspace.yml
agents:
  pr-reviewer:
    type: llm
    description: "Reviews pull requests using GitHub tools"
    config:
      provider: anthropic
      model: claude-sonnet-4-5
      prompt: |
        Review the pull request and post a summary comment.
      tools:
        - github/create_pull_request_review
        - github/get_pull_request
        - github/get_pull_request_files
The LLM decides when and how to call tools based on the task and prompt.

​
Using tools in a custom Python agent

Python agents call tools via ctx.tools — tool names are bare (no prefix) when calling from code: 
result = ctx.tools.call("get_pull_request", {"owner": "myorg", "repo": "myrepo", "pull_number": 42})
See the MCP tools guide for the full Python API.

​
atlas agents and MCP

type: atlas bundled agents are self-contained — they have their own built-in tool surfaces and ignore the tools array entirely. If you need a specific MCP tool called, use type: llm instead.

​
Common servers

ServerInstallWhat it provides
GitHubnpx -y @modelcontextprotocol/server-githubRepos, PRs, issues, commits
Postgresnpx -y @modelcontextprotocol/server-postgresSQL queries on Postgres
Filesystemnpx -y @modelcontextprotocol/server-filesystemRead/write local files
Timeuvx mcp-server-timeCurrent time, timezone conversion
Fetchuvx mcp-server-fetchHTTP fetch as a tool
Browse the full registry at github.com/modelcontextprotocol/servers.

​
Transport

Only stdio transport is supported — Friday spawns the server as a child process and communicates over stdin/stdout. SSE transport is planned.