evc-team-relay-mcp

Instructions

Implementation Reference

• relay_mcp.py:219-245 (handler)

  The read_document tool handler - reads document content from the EVC Relay API by doc_id. For doc shares, doc_id defaults to share_id. Uses authentication headers and returns JSON response with doc_id, content, and format.

  @mcp.tool()
  def read_document(share_id: str, doc_id: str = "", key: str = "contents") -> str:
      """Read document content by doc_id (low-level).
  
      For doc shares, omit doc_id — it defaults to share_id.
      For folder shares, pass the file's doc_id from list_files.
      Prefer read_file for folder shares.
  
      Args:
          share_id: UUID of the share (for ACL check).
          doc_id: Document UUID. Defaults to share_id for doc shares.
          key: Yjs shared type key. Default "contents".
  
      Returns:
          JSON with doc_id, content, format.
      """
      if not doc_id:
          doc_id = share_id
  
      with _get_client() as client:
          r = client.get(
              f"{_get_base_url()}/v1/documents/{doc_id}/content",
              headers=_headers(),
              params={"share_id": share_id, "key": key},
          )
          r.raise_for_status()
      return r.text

• relay_mcp.py:219-220 (registration)

  The @mcp.tool() decorator registers read_document as an MCP tool with the FastMCP server.

  @mcp.tool()
  def read_document(share_id: str, doc_id: str = "", key: str = "contents") -> str: